A versão 4.8 da Carteira Digital Móvel Algorand aumenta a capacidade de usar códigos QR para criar e enviar transações básicas. Este documento fornece uma breve visão geral de como desenvolvedores e usuários podem tirar proveito desta funcionalidade melhorada.
Para Desenvolvedores
Os desenvolvedores nos ecossistemas Algorand podem encontrar uma situação em que querem estimular os usuários a criar e enviar transações específicas. Por exemplo, uma cafeteria que aceita o USDC Algorand como pagamento precisará que os clientes criem transações com um valor específico, com um ID de ativo sendo transferido, e talvez um valor específico no campo da nota.
Isto é possível através do uso de URIs Algorand. As seções abaixo explicam como construir os URIs Algorand e os códigos QR que são compatíveis com a Carteira Digital Móvel Algorand.
Esquema URI
A fim de incitar os usuários a criar transações que enviem Algos ou ASAs, primeiro é necessário construir um URI que esteja em conformidade com o esquema URI Algorand. Quando um usuário abre um URI Algorand e ele tem a Carteira Digital Móvel instalada, o aplicativo abrirá e manipulará o URI adequadamente.
O URI Algorand deve começar com algorand://, seguido pelo endereço do receptor, e depois parâmetros para a transação. Por exemplo:
algorand://WSJHNPJ6YCLX5K4GUMQ4ISPK3ABMS3AL3F6CSVQTCUI5F4I65PWEMCWT3M?amount=5000000&asset=31566704&xnote=Order%20250
Este URI é um prompt para transferir 5 USDC para o endereço WSJHNPJ6YCLX5K4GUMQ4ISPK3ABMS3AL3F6CSVQTCUI5F4I65PWEMCWT3M com uma nota de “Ordem 250”.
Abaixo estão breves descrições de alguns dos parâmetros. Uma descrição completa do Esquema URI Algorand e seus parâmetros também está disponível.
asset: Este parâmetro determina se a transação enviará Algos ou um ASA. Se você quiser enviar um ASA, defina este parâmetro para o ID do ASA. Caso contrário, se este parâmetro não estiver presente, a transação enviará Algos.
amount: Esta é a quantidade de Algod ou de ASA a ser enviada na transação. Observe que esta quantia está na menor unidade do ativo. Para Algos, a menor unidade é o microAlgo. 1.000.000 microAlgos = 1 Algo.
Para os ASAs, a menor unidade depende do número de decimais que o ASA está configurado para ter. Se um ASA tem d decimais, então uma quantidade de 10 ^d unidades básicas é equivalente a 1 unidade do ativo.
note e xnote: Estes parâmetros podem ser usados para especificar o que o campo da nota da transação deve conter. O valor deste parâmetro deve ser codificado em porcentagem se ele contiver caracteres especiais. Se "note" for usado, então o usuário terá a opção de editar o campo da nota antes de submeter a transação. Se "xnote" for usado, o campo da nota não será editável pelo usuário. Se sua aplicação tiver requisitos rigorosos para o campo note, é melhor usar "xnote". Você não deve especificar tanto "note" quanto "xnote".
Criação do Código QR
Além de provocar transações com URIs, você também pode transformar estes URIs em códigos QR que os usuários podem digitalizar para criar transações.
Para fazer isso, primeiro crie um URI para suas transações, codificando-o como um código QR usando qualquer biblioteca ou ferramenta padrão de conversão QR. Por exemplo, aqui está o mesmo URI de antes como um código QR:
Uma vez gerado o código QR, você está pronto para mostrá-lo aos usuários!
Para os usuários
Os usuários devem estar cientes de que podem usar a funcionalidade de digitalização de QR da Carteira Digital Algorand para assinar transações específicas do aplicativo. URIs Algorand e códigos QR para criar transações de pagamento. Esta seção descreve como a Carteira Digital Móvel Algorand pode ser usada para criar transações como esta.
Digitalização de Códigos QR
Para digitalizar um código QR, pressione o botão QR no canto superior direito da tela inicial.
Isto abrirá uma tela que utiliza a câmera de seu dispositivo para digitalizar um código QR. Uma vez que o código tenha sido escaneado, você pode seguir os mesmos passos da seção abaixo para abrir um URI Algorand.
Abertura de URIs Algorand
Para criar uma transação a partir de um URI Algorand, basta pressionar o URI. Isto abrirá a Carteira Digital Móvel Algorand na seguinte tela:
A partir desta tela, você pode escolher qual conta será o remetente da transação. Após escolher o remetente, você verá uma tela de criação de transação com todos os valores do URI preenchidos:
Se tudo parecer aceitável, pressione o botão de visualização para continuar para a tela de confirmação da transação
Esta é sua última chance de rever a transação antes de ser submetida à rede. Se você estiver satisfeito com ela, pressione send!
Agora você criou com sucesso uma transação a partir de um código QR ou URI
Algorand .
O que vem a seguir?
Embora estejamos entusiasmados em lançar esta funcionalidade para codificar transações básicas da Algorand, também estamos trabalhando arduamente para suportar transações mais complexas e chamadas de aplicativos. Nossa esperança é que você seja capaz de usar a Carteira Digital Algorand para assinar uma infinidade de transações de qualquer tipo de aplicações diferentes.
Finalmente, este é um recurso que já foi solicitado muitas vezes pelos desenvolvedores e membros da comunidade Algorand, e por favor, continue com o feedback! Se você tiver comentários ou precisar de ajuda na integração da Carteira Digital Algorand com seus fluxos de trabalho de aplicativos, por favor entre em contato conosco no Discord no canal #algorand-wallet.
Artigo escrito por Jason Paulos e publicado no Portal do Desenvolverdor Algorand. Tradução e adaptação por Marcelo Panegali.
Oldest comments (0)