FA1.2 (Tezos)

O que é FA1.2 na Tezos?

FA1.2 é um padrão de token fungível para contratos inteligentes na blockchain Tezos.Ele define uma interface comum para transferir tokens, aprovar gastos com tokens, consultar saldos e permissões de gasto e verificar a oferta total de tokens.

FA1.2 é definido formalmente pela Proposta de Melhoria da Tezos 7, também conhecida como TZIP-7.

O padrão foi desenvolvido especificamente para tokens fungíveis, ou seja, cada unidade de um determinado ativo FA1.2 é intercambiável por qualquer outra unidade do mesmo ativo.Um contrato FA1.2 pode representar um token de pagamento, token de governança, criptomoeda wrapped, ativo de valor estável, ponto de fidelidade, moeda de aplicativo ou outro ativo digital divisível.FA1.2 é uma interface de contrato inteligente, não uma criptomoeda por si só.Cada token FA1.2 é criado e gerenciado por seu próprio contrato inteligente na Tezos.O contrato mantém um registro que associa endereços de contas da Tezos aos saldos de tokens.Os usuários interagem com o contrato para transferir tokens ou autorizar outra conta ou aplicativo a gastar, em seu nome, uma quantidade limitada.FA1.2 não determina o preço, o status jurídico, a finalidade econômica, a oferta máxima nem a estrutura administrativa de um token.Essas características dependem do contrato individual do token e do projeto que o controla.

O que significa FA1.2?

FA significa Financial Application (aplicação financeira).O número 1.2 identifica a versão da interface de ativos fungíveis definida pela TZIP-7.O padrão se desenvolveu a partir de trabalhos anteriores sobre interfaces de tokens fungíveis da Tezos e acrescentou um sistema formal de aprovação para transferências delegadas de tokens.O termo FA1.2 costuma se referir tanto ao padrão quanto aos tokens implementados de acordo com ele.No entanto, tecnicamente, é o contrato inteligente que segue o padrão FA1.2.Um token não se torna compatível com FA1.2 apenas porque o emissor usa esse termo em um nome, símbolo, site ou descrição de marketing.O contrato implantado precisa disponibilizar os entrypoints obrigatórios com os tipos de parâmetros e o comportamento esperados.

Por que o FA1.2 foi criado?

Os contratos inteligentes podem definir o comportamento dos tokens de muitas maneiras diferentes.Sem um padrão compartilhado, cada carteira e aplicativo descentralizado precisaria de código de integração personalizado para cada token fungível.Um token poderia usar um nome para transferências, enquanto outro usaria uma estrutura de parâmetros completamente diferente.As consultas de saldo e as permissões de gasto também poderiam funcionar de maneiras distintas entre os contratos.FA1.2 oferece uma interface previsível que reduz essa fragmentação.As carteiras podem preparar transferências de tokens usando um entrypoint de transferência conhecido.Os aplicativos podem solicitar permissão de gasto por meio de um entrypoint de aprovação conhecido.Os indexadores podem identificar alterações de saldo e apresentar a atividade dos tokens em um formato consistente.As ferramentas de desenvolvimento podem verificar se um contrato disponibiliza a interface FA1.2 esperada.

A documentação atual do FA1.2 no Octez inclui ferramentas específicas para verificar compatibilidade, transferir tokens, aprovar gastadores e consultar informações sobre tokens.

A padronização melhora a interoperabilidade, mas não garante que um contrato específico seja seguro, valioso ou administrado de forma honesta.

Como funciona um token FA1.2?

Um token FA1.2 é gerenciado por um contrato inteligente da Tezos que armazena um registro de saldos das contas.Quando os tokens são emitidos, o contrato atribui saldos a um ou mais endereços de conta.O titular transfere tokens chamando o contrato, em vez de enviá-los diretamente pelo sistema de contabilização de saldos no nível do protocolo Tezos.O contrato verifica a conta de origem, a conta de destino, o valor solicitado, a autorização do chamador e o saldo disponível.Se as verificações forem aprovadas, o contrato subtrai o valor do saldo de origem e o adiciona ao saldo de destino.Se alguma verificação falhar, a transação é revertida e o registro permanece inalterado.Uma conta também pode aprovar outra conta ou contrato inteligente para gastar uma quantidade limitada do seu saldo.O valor aprovado é chamado de permissão de gasto (allowance).Cada transferência delegada normalmente reduz a permissão restante pelo valor transferido.O contrato pode fornecer informações sobre saldo, permissões de gasto e oferta total por meio de interfaces de consulta padronizadas.

O que é fungibilidade?

Fungibilidade significa que unidades individuais de um ativo são intercambiáveis.Uma unidade de determinado token FA1.2 tem as mesmas propriedades definidas pelo contrato que outra unidade desse token.Em geral, o titular não precisa acompanhar qual unidade específica do token recebeu.O registro da conta armazena quantidades, e não identidades únicas de tokens.Isso torna o FA1.2 adequado para ativos destinados a funcionar como moedas, créditos, unidades de voto, garantias ou direitos divisíveis.FA1.2 não foi desenvolvido para atribuir uma identidade única e um registro de metadados separado a cada unidade.Ativos digitais únicos geralmente são implementados por meio de um padrão de token mais flexível, desenvolvido para oferecer suporte a tokens não fungíveis.

Como identificar um token FA1.2?

Um token FA1.2 é identificado principalmente pelo endereço do contrato inteligente da Tezos que o gerencia.FA1.2 representa um tipo de token fungível por contrato, em vez de usar vários IDs de token para ativos não relacionados.Quando os metadados de FA1.2 usam a estrutura de metadados de token associada a padrões posteriores da Tezos, o ID do token deve ser 0.O nome e o ticker do token não são identificadores únicos confiáveis.Contratos diferentes podem usar o mesmo nome, símbolo, imagem e configuração de casas decimais.Um emissor mal-intencionado também pode copiar a identidade visual de um ativo legítimo.Antes de transferir, aprovar ou comprar um token FA1.2, os usuários devem verificar o endereço completo do contrato em documentação confiável do projeto.

Quais são os principais entrypoints do FA1.2?

A interface FA1.2 define entrypoints para transferências, aprovações, consultas de saldo, consultas de permissões de gasto e consultas da oferta total.

A referência oficial da interface do Octez lista transfer, approve, getBalance, getAllowance e getTotalSupply como as principais operações do FA1.2.

Contratos individuais podem incluir entrypoints adicionais para emissão, queima, pausa, administração, resgate ou outras funcionalidades específicas do projeto.Entrypoints adicionais não fazem automaticamente parte do padrão FA1.2.

Entrypoint transfer

O entrypoint transfer move uma quantidade específica de tokens de um endereço para outro.A chamada identifica o endereço de origem, o endereço de destino e o valor da transferência.Quando o chamador transfere tokens da própria conta, o contrato verifica se há saldo suficiente.Quando o chamador transfere tokens de outra conta, ele precisa ter uma permissão de gasto suficiente concedida pelo titular.Uma transferência delegada reduz a permissão restante do gastador.A transferência falha quando o saldo ou a permissão de gasto é insuficiente.O entrypoint transfer do FA1.2 reúne transferências diretas pelo titular e transferências delegadas em uma única interface.

Entrypoint approve

O entrypoint approve permite que o titular de tokens autorize um gastador a transferir uma quantidade limitada de seus tokens.O gastador pode ser outra conta de usuário ou um contrato inteligente.Os aplicativos podem usar esse mecanismo para receber pagamentos, fornecer liquidez, bloquear garantias, realizar negociações ou executar outras ações autorizadas.A aprovação não transfere os tokens imediatamente.Ela cria uma permissão de gasto que pode ser usada em chamadas de transferência posteriores.O titular continua sendo dono dos tokens até que ocorra uma transferência autorizada.

Entrypoint getBalance

O entrypoint getBalance retorna o saldo do token FA1.2 associado a um endereço específico.O saldo informado é armazenado no contrato do token, não no saldo de tez no nível do protocolo.Uma carteira, um indexador ou um aplicativo pode usar essa informação para mostrar quantos tokens uma conta controla.As ferramentas atuais do Octez podem consultar saldos compatíveis off-chain sem exigir que o usuário envie uma transação separada apenas para obter essa informação.

Entrypoint getAllowance

O entrypoint getAllowance retorna a quantidade restante que um endereço pode transferir de outro endereço.A consulta identifica tanto o titular dos tokens quanto o gastador aprovado.Um resultado igual a zero significa que o gastador não tem atualmente nenhuma permissão FA1.2 restante concedida por aquele titular.Um resultado positivo mostra a quantidade máxima que ainda pode ser transferida com base na autorização registrada.

Entrypoint getTotalSupply

O entrypoint getTotalSupply retorna o número total de unidades de token FA1.2 reconhecidas pelo contrato.A oferta total pode mudar quando a implementação inclui funcionalidades de emissão ou queima.Uma consulta da oferta total não revela a concentração dos tokens entre os titulares.Ela também não informa se outros tokens poderão ser criados no futuro.

O que é uma permissão de gasto FA1.2?

Uma permissão de gasto FA1.2 é uma autorização limitada concedida pelo titular de um token a outro endereço.Suponha que um titular aprove um aplicativo para gastar 100 tokens.O aplicativo poderá transferir até 100 tokens do saldo do titular, sujeito às regras do contrato.Se o aplicativo transferir 30 tokens, a permissão restante normalmente será de 70 tokens.O aplicativo não poderá transferir mais do que o saldo disponível do titular, mesmo que a permissão registrada seja maior.O aplicativo também não poderá usar a permissão em outro contrato de token FA1.2.As permissões permanecem registradas on-chain até serem usadas, alteradas ou redefinidas.Desconectar uma carteira de um site não cancela automaticamente uma permissão.Quando quiser revogar a autorização, o titular deverá enviar uma atualização de aprovação on-chain.

Qual é a diferença entre uma permissão FA1.2 e uma autorização de operador?

FA1.2 usa permissões de gasto numéricas.O titular escolhe a quantidade máxima que o gastador pode transferir.Em geral, a permissão diminui à medida que as transferências ocorrem.Um modelo de token baseado em operadores costuma conceder permissão para um determinado tipo de token sem especificar uma quantidade numérica decrescente.Essa diferença pode afetar as interfaces de carteira e a segurança dos aplicativos.Uma aprovação FA1.2 de 50 unidades não deve ser exibida como se concedesse controle ilimitado.Da mesma forma, uma autorização de operador não deve ser interpretada como uma permissão numérica válida para uma única transferência.

Por que as alterações de permissões FA1.2 exigem cuidado?

Alterar uma permissão de gasto existente pode criar uma condição de corrida.Um gastador pode tentar usar a permissão antiga antes da confirmação da nova aprovação do titular.Depois que a nova permissão entrar em vigor, o gastador poderá tentar usá-la também.A TZIP-7 aborda parte desse problema ao proibir a alteração direta de uma permissão diferente de zero para outra permissão diferente de zero.Em geral, o titular precisa definir a permissão como zero antes de atribuir um novo valor diferente de zero.

A especificação de permissões da TZIP-7 também explica que redefinir o valor para zero, por si só, não garante proteção completa contra todos os cenários de temporização adversarial.

Um usuário cuidadoso deve aguardar a inclusão da transação que zera a permissão antes de conceder uma nova.Aplicativos que movimentam valores altos também devem verificar se o gastador usou alguma permissão enquanto a atualização estava pendente.

Exemplo de permissão de gasto FA1.2

Suponha que uma carteira tenha 1.000 unidades de um token FA1.2.O titular aprova um aplicativo descentralizado para gastar 200 unidades.Mais tarde, o aplicativo transfere 75 unidades para um contrato inteligente.O saldo de tokens do titular cai para 925 unidades.A permissão restante do aplicativo cai para 125 unidades.Se o aplicativo tentar transferir mais 150 unidades, a transação falhará porque a permissão restante é insuficiente.O titular pode reduzir a permissão a zero quando o aplicativo não precisar mais de acesso.

FA1.2 oferece suporte a aprovações ilimitadas?

Um titular de FA1.2 pode aprovar um valor numérico muito alto, se o contrato aceitar esse valor.Alguns aplicativos podem tratar isso como uma aprovação efetivamente ilimitada.Uma permissão elevada reduz a necessidade de transações repetidas de aprovação.Ela também aumenta o valor em risco caso o contrato aprovado seja comprometido, mal-intencionado ou usado de forma incorreta.Quando for viável, os usuários devem aprovar apenas a quantidade razoavelmente necessária.Permissões antigas ou desnecessárias devem ser redefinidas para zero.

Como os saldos FA1.2 são armazenados?

Uma implementação FA1.2 normalmente armazena os saldos em um registro dentro do contrato do token.O registro associa o endereço de cada titular a uma quantidade de tokens expressa em números naturais.Algumas implementações armazenam os saldos e as permissões em conjunto em uma entrada estruturada do registro.A TZIP-7 descreve uma estrutura padronizada e indexável em que o registro de um titular pode conter tanto seu saldo quanto um mapa das permissões dos gastadores.Nem toda implementação histórica precisa usar um armazenamento interno idêntico, desde que seu comportamento público corresponda à interface exigida.Os aplicativos devem interagir por meio dos entrypoints padrão ou de dados indexados confiáveis, em vez de presumir uma estrutura específica de armazenamento privado.

FA1.2 usa IDs de token?

FA1.2 é um padrão de contrato para um único token e não usa IDs de token para distinguir vários tipos independentes em transferências comuns.Quando os metadados do token FA1.2 são representados pelo formato compartilhado com padrões mais recentes, o ID do token é fixado em 0.Um contrato que precisa gerenciar muitos tokens fungíveis separados sob um único endereço geralmente é mais adequado a um padrão multiativo.Os usuários não devem presumir que o ID de token 0 identifica exclusivamente um ativo FA1.2 sem também conhecer o endereço do contrato.

Como funcionam os metadados FA1.2?

A interface original FA1.2 se concentra principalmente no comportamento do registro e das permissões.A TZIP-7 não define, de forma independente, um sistema completo de metadados de contrato.As orientações atuais sobre metadados de tokens usam a mesma estrutura geral associada ao padrão multiativo da Tezos.O ID de token usado nos metadados FA1.2 deve ser 0.Os metadados podem incluir o nome, símbolo, casas decimais, descrição e outras informações de exibição do token.

Informações no nível do contrato também podem ser publicadas de acordo com os metadados de contrato da TZIP-16.

A TZIP-16 permite armazenar metadados on-chain ou referenciá-los em locais off-chain, como armazenamento endereçado por conteúdo ou serviços web.Os metadados ajudam carteiras e exploradores a exibir um ativo, mas não controlam o registro real, a menos que o contrato os utilize explicitamente na lógica de negócio.

O que significa decimals em um token FA1.2?

Os saldos FA1.2 são armazenados em unidades inteiras de números naturais.O campo de metadados decimals informa às carteiras onde posicionar a vírgula decimal na exibição.Suponha que o saldo bruto do contrato seja 1.500.000 e que o token use seis casas decimais.A carteira exibirá o saldo como 1,5 token.O contrato inteligente continuará registrando 1.500.000 unidades mínimas.O número de casas decimais não determina o preço de mercado, a oferta total nem a escassez do token.Um valor incorreto de decimals pode fazer uma carteira ou aplicativo exibir uma quantidade enganosa.

FA1.2 define uma oferta máxima?

Não. FA1.2 não exige uma oferta máxima fixa.O contrato oferece uma forma de consultar a oferta total, mas o emissor pode adicionar funcionalidades personalizadas de emissão ou queima.Um token pode começar com uma oferta fixa e não ter nenhum método para criar mais unidades.Outro token pode permitir que um administrador, contrato de governança ou processo definido pelo protocolo emita unidades adicionais.Antes de presumir que a oferta é permanentemente limitada, os usuários devem verificar o contrato implantado e as permissões administrativas.Um número de oferta publicado descreve o estado atual e não necessariamente a emissão futura.

FA1.2 exige emissão de tokens?

Não, a emissão não é um dos entrypoints obrigatórios do FA1.2.Um contrato pode criar toda a oferta durante a implantação.Também pode incluir uma função personalizada de emissão controlada por um administrador ou outro contrato inteligente.A política de emissão deve identificar quem pode criar tokens, se existe um limite de oferta e se a autoridade pode ser transferida ou removida.Uma emissão não autorizada ou ilimitada pode diluir os titulares existentes e afetar os mercados do token.

FA1.2 exige queima de tokens?

Não, a queima também é opcional.Uma função de queima personalizada pode reduzir permanentemente os saldos e a oferta total de acordo com as regras do contrato.A função pode permitir que os titulares queimem seus próprios tokens ou pode ser restrita a um administrador.Enviar tokens para um endereço inacessível nem sempre atualiza a oferta total informada pelo contrato.Uma queima real no nível do contrato deve reduzir tanto o saldo pertinente quanto a contabilização da oferta total, quando esse for o objetivo do projeto.

FA1.2 vs. tez

Tez é a criptomoeda nativa da blockchain Tezos.Tokens FA1.2 são criados e gerenciados por contratos inteligentes.Os saldos de tez são mantidos diretamente pelo protocolo Tezos.Os saldos FA1.2 são mantidos no armazenamento de um contrato individual de token.As taxas de transação da Tezos geralmente são pagas em tez, mesmo quando a transação transfere um token FA1.2.Ter saldo FA1.2 não fornece automaticamente tez suficiente para pagar uma transferência de token ou uma transação de aprovação.

A documentação de tokens da Tezos explica a diferença entre tez no nível do protocolo e tokens representados por registros de contratos inteligentes.

FA1.2 vs. FA2

FA1.2 foi desenvolvido especificamente para um token fungível gerenciado por um contrato inteligente.FA2 é uma interface de token mais recente e flexível.FA2 pode oferecer suporte a tokens fungíveis, NFTs, ativos intransferíveis, modelos híbridos e vários IDs de token em um único contrato.FA1.2 usa permissões numéricas para gastadores.O padrão FA2 normalmente usa permissões de operador específicas para cada token, em vez de permissões numéricas decrescentes.FA1.2 usa estruturas de transferência separadas para uma única solicitação, enquanto FA2 usa estruturas de transferência e consulta de saldo orientadas a lotes.FA2 também oferece suporte mais explícito a políticas de transferência personalizadas.As orientações atuais do SmartPy recomendam FA2 para novos contratos de token, pois ele oferece suporte a uma gama mais ampla de casos de uso.Essa recomendação não torna inválidos os contratos FA1.2 existentes.As ferramentas atuais do Octez continuam oferecendo suporte específico a FA1.2.

FA1.2 vs. FA2.1

FA2.1 é uma evolução proposta da família FA2 que inclui recursos como permissões finitas, eventos, visualizações on-chain e funcionalidades relacionadas a tickets.O conceito de permissões finitas atende a um caso de uso conhecido do FA1.2, mantendo a estrutura multiativo mais ampla do FA2.

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

Contratos FA1.2 existentes não mudam automaticamente quando novos padrões são propostos.O suporte de carteiras e aplicativos deve ser verificado separadamente para cada padrão.

É possível converter um token FA1.2 para FA2?

Normalmente, não é possível transformar um contrato FA1.2 em FA2 apenas alterando seu nome.Os dois padrões usam interfaces e modelos de permissão diferentes.Um projeto que queira migrar pode implantar um novo contrato FA2 e criar um processo controlado de conversão.O processo pode bloquear ou queimar os tokens antigos e emitir tokens novos correspondentes.Outro modelo pode registrar um snapshot dos saldos e distribuir ativos substitutos.A migração cria riscos técnicos, de governança, de segurança e de experiência do usuário.Os usuários devem verificar o contrato oficial de migração e evitar links não solicitados que aleguem trocar tokens antigos.

FA1.2 oferece suporte a criptoativos wrapped?

Sim, um contrato FA1.2 pode representar uma criptomoeda wrapped na Tezos.Um token wrapped é um ativo de contrato inteligente separado, criado para acompanhar outro ativo por meio de um mecanismo de custódia, bridge, emissão ou resgate.A interface FA1.2 padroniza transferências e permissões, mas não garante que o token wrapped tenha cobertura integral.Os usuários precisam avaliar as reservas, as condições de resgate, os controles do custodiante, a segurança da bridge, a autoridade de emissão e a comprovação das reservas.

As orientações oficiais da Tezos sobre tokens wrapped destacam que um ativo wrapped é tecnicamente diferente da criptomoeda original.

FA1.2 oferece suporte a tokens de valor estável?

Sim, um token FA1.2 pode ser projetado para acompanhar o valor de uma moeda fiduciária, commodity, criptomoeda ou outro ativo de referência.O próprio FA1.2 não mantém o valor de referência.A estabilidade do preço depende do emissor, das garantias, das reservas, do mecanismo de resgate, da liquidez de mercado, do sistema de oráculos e do projeto econômico.Um token pode estar em conformidade com FA1.2 e, ainda assim, perder a paridade pretendida.A conformidade técnica não deve ser considerada prova da qualidade das reservas ou da estabilidade do preço.

Como as carteiras exibem tokens FA1.2?

Uma carteira pode identificar um contrato FA1.2, consultar o saldo do usuário e ler os metadados disponíveis.Ela pode exibir o nome, o símbolo, o saldo ajustado pelas casas decimais, o logotipo e o histórico de transações do token.Algumas carteiras usam indexadores em vez de consultar cada contrato diretamente.

A documentação de indexadores da Tezos explica que os indexadores organizam informações de tokens FA1.2 e FA2 para facilitar o acesso por aplicativos.

Um token pode não aparecer automaticamente se seus metadados estiverem ausentes, não forem compatíveis ou ainda não tiverem sido indexados.A ausência do token na carteira não significa necessariamente que o saldo on-chain seja zero.Os usuários podem verificar o contrato e as informações do registro usando ferramentas blockchain compatíveis.

Como os aplicativos descentralizados usam FA1.2?

Um aplicativo descentralizado pode solicitar aprovação para gastar uma quantidade definida de um token FA1.2.Após a aprovação, o aplicativo pode chamar o contrato do token para transferir tokens do saldo do titular.Esse padrão pode viabilizar depósitos, swaps, garantias, assinaturas, leilões, empréstimos, pagamentos e outras atividades cripto.O aplicativo não deve solicitar uma permissão maior do que a razoavelmente necessária.Antes de assinar, o usuário deve verificar o contrato do token, o endereço do gastador e o valor aprovado.O aplicativo também deve tratar com segurança saldos insuficientes, permissões insuficientes e aprovações alteradas.

É possível agrupar transferências FA1.2?

O entrypoint transfer principal do FA1.2 descreve uma origem, um destino e um valor por chamada.No entanto, uma operação da Tezos pode conter várias chamadas de contrato.As ferramentas atuais do Octez oferecem suporte a comandos de transferência em lote que envolvem uma única origem e vários destinatários em contratos FA1.2.O agrupamento pode facilitar distribuições e operações de tesouraria.Uma falha em uma sequência atômica pode fazer a operação relacionada falhar, em vez de deixar um resultado parcialmente concluído.Lotes grandes também podem consumir bastante gas e exigem testes cuidadosos.

Erros padrão do FA1.2

A TZIP-7 define erros associados a permissões insuficientes e alterações inseguras de permissões.Uma transferência pode falhar quando o titular não tem tokens suficientes.Uma transferência delegada pode falhar quando a permissão do gastador é menor que o valor solicitado.Uma aprovação pode falhar ao tentar substituir diretamente uma permissão diferente de zero por outra permissão diferente de zero.Implementações individuais podem usar nomes de erro adicionais para administração, pausa, emissão, queima ou outros recursos personalizados.Os aplicativos devem exibir erros em uma linguagem que ajude os usuários a entender se o problema está relacionado ao saldo, à permissão, à autorização ou às políticas do contrato.

Riscos de segurança dos tokens FA1.2

A compatibilidade com FA1.2 não comprova que um contrato inteligente é seguro.Um contrato pode disponibilizar os entrypoints corretos e, ainda assim, conter lógica interna defeituosa ou mal-intencionada.Um administrador pode ter permissão para emitir novos tokens, pausar transferências, congelar contas, alterar metadados ou substituir endereços essenciais.Um gastador aprovado que tenha sido comprometido pode transferir tokens até o limite da permissão disponível.Um nome e símbolo copiados podem fazer um token fraudulento parecer legítimo.Um token wrapped pode ficar subcolateralizado mesmo que seu registro FA1.2 funcione corretamente.Os usuários devem analisar o código-fonte do contrato, as auditorias, a administração, os controles de oferta, as permissões e as regras de resgate.

Risco de segurança das permissões

Uma permissão concede a outro endereço autoridade direta sobre parte do saldo de tokens do titular.Um aplicativo mal-intencionado pode usar a permissão imediatamente após a aprovação.Um contrato comprometido pode usar permissões concedidas antes do comprometimento.Uma permissão elevada e não utilizada pode continuar ativa por muito tempo.Os usuários devem verificar cuidadosamente o endereço do gastador e evitar aprovar transações sem explicação.Permissões que não são mais necessárias devem ser redefinidas para zero.Chaves privadas e frases de recuperação nunca são necessárias para conceder ou revogar uma permissão FA1.2.

Risco de controle administrativo

Contratos FA1.2 personalizados podem incluir um administrador privilegiado.O administrador pode controlar emissão, queima, pausa, congelamento de contas, listas de bloqueio, taxas ou atualizações do contrato.Essas permissões podem apoiar operações de segurança e conformidade.Também podem gerar riscos de centralização e abuso.Os usuários devem verificar se o administrador é uma conta individual, um contrato multisig, um sistema de governança ou uma regra imutável.Também devem verificar se as permissões administrativas podem ser transferidas ou removidas permanentemente.

Risco de oferta e diluição

Um token pode apresentar uma oferta atual limitada e, ainda assim, manter autoridade ilimitada para emissão futura.Uma emissão adicional pode reduzir a parcela da oferta total representada por cada unidade existente.Um limite de oferta só é significativo quando é aplicado pelo contrato implantado ou por uma restrição de governança igualmente robusta.Promessas feitas em sites ou publicações nas redes sociais não substituem as permissões de emissão on-chain.Os usuários devem distinguir a oferta circulante, a oferta total e a possível oferta futura.

Risco de tokens falsos

Qualquer pessoa pode implantar um contrato inteligente na Tezos usando um nome ou símbolo de token conhecido.Os metadados da carteira podem fazer um token sem relação com o original parecer semelhante a um ativo reconhecido.O endereço do contrato é mais confiável do que o nome exibido.Os usuários devem obter o endereço verificado do contrato em fontes primárias confiáveis do projeto.Um token não solicitado recebido em uma carteira não deve ser considerado valioso sem verificação independente.Links nos metadados de tokens desconhecidos podem levar a sites de phishing.

Risco de contrato inteligente

Um erro de programação pode permitir transferências não autorizadas, saldos incorretos, tokens bloqueados ou contabilização de oferta defeituosa.A conformidade formal com a interface não prova que todas as ramificações da lógica interna funcionem corretamente.Uma auditoria independente pode reduzir riscos, mas não garante a inexistência de vulnerabilidades.Contratos com lógica complexa de emissão, resgate, taxas, atualização ou colateral exigem análise além dos entrypoints básicos do FA1.2.

As orientações de risco da Tezos para tokens recomendam verificar a disponibilidade do código-fonte, as auditorias, os limites de oferta e as regras de transferência.

Segurança de chaves privadas e carteiras

A titularidade de tokens FA1.2 depende, em última instância, do controle da conta Tezos autorizada a gerenciar o saldo registrado.Um invasor que obtenha a chave privada da conta pode assinar transferências e aprovações.Nenhum contrato legítimo de token precisa da frase de recuperação do usuário para exibir um saldo ou preparar uma transação.

A documentação de gerenciamento de chaves do Octez destaca práticas seguras de armazenamento e assinatura para operações com tez e tokens FA.

Antes de aprovar uma operação, os usuários devem verificar os detalhes da transação no dispositivo de assinatura.

Como verificar um token FA1.2

Confirme o endereço completo do contrato Tezos em uma fonte primária confiável.Verifique se o contrato disponibiliza a interface FA1.2 obrigatória.Analise o nome, o símbolo, as casas decimais e a oferta total do token.Determine quem pode emitir, queimar, pausar, congelar ou atualizar o token.Verifique as permissões existentes antes de interagir com um aplicativo novo.Quando houver ativos de valor envolvido, consulte avaliações de segurança independentes.No caso de tokens wrapped ou de valor estável, verifique separadamente as reservas e as regras de resgate, além da interface FA1.2.Não confie em um ticker, ícone de carteira ou mensagem em rede social como prova de autenticidade.

Boas práticas de desenvolvimento FA1.2

Os desenvolvedores devem seguir exatamente os tipos de entrypoint e o comportamento de autorização da TZIP-7.Transferências diretas pelo titular e transferências baseadas em permissões devem ser testadas separadamente.Os testes devem abranger saldos zero, saldos insuficientes, permissões insuficientes e transferências de valor zero.As alterações de permissões devem seguir a proteção padrão contra atualizações diretas de um valor diferente de zero para outro valor diferente de zero.Quando houver funcionalidades de emissão, queima, pausa ou administração, elas devem ser documentadas com clareza.Quando viável, os metadados devem usar armazenamento estável e protegido contra alterações.Os aplicativos devem usar a identidade do chamador apropriada à interação imediata com o contrato, em vez de confiar na origem de uma transação não relacionada.Os desenvolvedores devem testar integrações com carteiras, indexadores e ferramentas do Octez.Contratos de alto valor devem passar por uma análise de segurança independente antes da implantação.

Equívocos comuns sobre FA1.2

FA1.2 não é a criptomoeda nativa da Tezos.FA1.2 não é um token ou projeto específico.É um padrão que contratos de tokens fungíveis podem implementar.FA1.2 não oferece suporte a NFTs únicos como modelo principal de token.A conformidade com FA1.2 não garante uma oferta fixa.Emissão e queima não são entrypoints obrigatórios do padrão.Uma aprovação não transfere tokens imediatamente.Desconectar uma carteira não revoga uma permissão on-chain.O nome ou símbolo de um token não identifica exclusivamente seu contrato.O fato de FA2 ser o padrão preferencial para novos projetos não elimina os contratos FA1.2 existentes.Uma interface FA1.2 correta não garante que o token seja seguro, tenha cobertura, possa ser transferido em todas as condições ou tenha valor financeiro.

Perguntas frequentes

O que é FA1.2 na Tezos?

FA1.2 é um padrão de contrato inteligente para tokens fungíveis na Tezos, definido pela TZIP-7.

O que significa FA em FA1.2?

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

FA1.2 é uma criptomoeda?

Não. É uma interface usada para criar e gerenciar criptomoedas fungíveis e outros ativos tokenizados.

FA1.2 ainda tem suporte?

Sim. A documentação atual do Octez continua oferecendo ferramentas específicas de compatibilidade, transferência, aprovação e consulta de FA1.2.

FA1.2 é o padrão de token mais recente da Tezos?

Não. FA2 é mais recente e flexível, enquanto FA2.1 é atualmente descrito como uma proposta de evolução da família FA2.

Os desenvolvedores devem criar novos tokens FA1.2?

As orientações atuais de desenvolvimento da Tezos geralmente recomendam FA2 para novos contratos de token, embora os requisitos do projeto e as integrações legadas possam ser diferentes.

FA1.2 pode criar NFTs?

FA1.2 foi desenvolvido para tokens fungíveis, e não para ativos únicos e não fungíveis.

Um contrato FA1.2 pode gerenciar vários tipos de token?

O padrão representa um tipo de token fungível por contrato.

Como identificar um token FA1.2?

Ele é identificado principalmente pelo endereço do contrato Tezos que gerencia seu registro.

Qual ID de token o FA1.2 usa nos metadados?

O ID de token usado no formato compartilhado de metadados de tokens deve ser 0.

Onde os saldos FA1.2 são armazenados?

Eles são registrados no armazenamento do contrato inteligente FA1.2.

O que é o entrypoint transfer do FA1.2?

Ele transfere uma quantidade específica de um endereço de origem para um endereço de destino após as verificações de saldo e autorização.

O que é o entrypoint approve do FA1.2?

Ele concede a um gastador permissão para transferir até uma quantidade definida do saldo de tokens do titular.

O que é uma permissão de gasto FA1.2?

É a quantidade restante que um endereço aprovado pode transferir do saldo de um titular de tokens.

A permissão diminui após o uso?

Sim. Uma transferência delegada normalmente reduz a permissão restante pelo valor transferido.

Conectar uma carteira cria uma permissão?

Não. A permissão só é criada quando o usuário assina e envia a operação de aprovação pertinente.

Desconectar uma carteira revoga uma permissão?

Não. O titular precisa atualizar a permissão on-chain, normalmente definindo-a como zero.

Posso alterar diretamente uma permissão diferente de zero para outra?

A TZIP-7 proíbe alterações diretas de uma permissão diferente de zero para outra como proteção contra uma condição de corrida conhecida.

Como uma permissão deve ser alterada?

Primeiro, o titular deve definir a permissão como zero e aguardar a confirmação. Em seguida, pode atribuir o novo valor, após verificar se houve gastos nesse intervalo.

FA1.2 exige emissão de tokens?

Não. Uma função de emissão é opcional e depende da implementação individual.

FA1.2 exige queima de tokens?

Não. A queima também é um recurso personalizado opcional.

FA1.2 garante um limite de oferta?

Não. Os usuários precisam verificar a autoridade de emissão efetiva e as regras de oferta do contrato.

Como consultar um saldo FA1.2?

Uma carteira compatível, um indexador, uma consulta de contrato ou um comando de saldo FA1.2 do Octez pode consultar o saldo do registro.

Como consultar uma permissão FA1.2?

A interface getAllowance ou um indexador compatível pode informar a permissão restante entre um titular e um gastador.

Como consultar a oferta total FA1.2?

A interface getTotalSupply retorna a oferta atual registrada pelo contrato do token.

As taxas de transação FA1.2 são pagas com o token?

As taxas de transação do protocolo Tezos geralmente são pagas em tez.

FA1.2 pode representar uma criptomoeda wrapped?

Sim, mas a conformidade com FA1.2 não garante reservas, resgate nem segurança da bridge.

FA1.2 pode representar um ativo de valor estável?

Sim, mas o padrão não garante que o ativo mantenha o preço pretendido.

Um administrador FA1.2 pode congelar tokens?

Uma implementação personalizada pode incluir poderes de congelamento ou pausa, embora eles não sejam exigidos pelo padrão.

É possível migrar um token FA1.2 para FA2?

Um projeto pode criar um processo de migração separado, mas o contrato antigo não se torna compatível com FA2 automaticamente.

Um token FA1.2 é seguro por seguir um padrão?

Não. A conformidade com o padrão melhora a compatibilidade da interface, mas não garante código seguro, administração honesta, cobertura, liquidez ou valor.

Conclusão

FA1.2 é o padrão de token fungível da Tezos, definido formalmente pela TZIP-7.Ele estabelece uma interface compartilhada para transferências, aprovações, saldos, permissões e informações sobre a oferta total.Um contrato inteligente FA1.2 mantém um registro que associa endereços da Tezos a saldos de tokens intercambiáveis.Seu sistema de permissões numéricas permite que os titulares autorizem aplicativos ou outras contas a transferir uma quantidade limitada de tokens.As permissões exigem gerenciamento cuidadoso porque permanecem ativas on-chain e podem gerar riscos de condição de corrida ou de comprometimento do contrato.FA1.2 não exige emissão, queima, pausa, congelamento, administração de metadados ou uma oferta máxima fixa.Esses recursos dependem da implementação de cada contrato.FA2 é agora o padrão mais flexível para novos projetos de tokens na Tezos, mas os contratos FA1.2 continuam tendo suporte e sendo usados.Antes de interagir com um token FA1.2 desconhecido, os usuários devem verificar o endereço do contrato, o valor da permissão, os controles de oferta, a autoridade administrativa, os metadados, o histórico de auditorias e as condições de resgate.A padronização FA1.2 melhora a compatibilidade entre carteiras, aplicativos, indexadores e ferramentas de desenvolvimento da Tezos, mas não garante que um token seja seguro, legítimo, líquido ou valioso.