[PT/EN/ES] Automação de recompensas para delegadores de Hive Power da Nexo Digital - PT. 1

5 months ago

_{If you wanna read this content in english, click here.}
_{Si quieres leer este contenido en español, haz clic aquí.}

Hey! Espero que essa publicação os encontre bem. Estou muito feliz em me apresentar como o novo desenvolvedor da Nexo Digital, me chamo Fernando e vocês podem me encontrar na Hive a partir do usuário @sousafrc. Vamos falar hoje sobre o primeiro software desenvolvido para benefício dos delegadores de Hive Power para a comunidade Nexo Digital.

Hoje em dia, a Nexo Digital recompensa tokens $NEXO para quem delega HP. Até então, os pagamentos dessas recompensas eram realizados manualmente uma vez por mês ou a cada duas semanas, dependendo da disponibilidade de tempo. Desenvolvemos então uma automação com o objetivo de calcular e pagar de forma automática essas recompensas, diariamente, para os nossos delegadores, evitando erros humanos e tirando a carga da equipe para focar no desenvolvimento e gestão da comunidade de forma mais eficaz.

Vamos trilhar uma espécie de linha do tempo que vai desde o convite do @lipe100dedos para a minha participação na comunidade como desenvolvedor, o processo de desenvolvimento, as dificuldades encontradas no caminho, até o que podemos esperar para o futuro da Nexo Digital, no contexto de tecnologia e desenvolvimento de novas ferramentas e softwares.

O início do projeto

No dia 3 de maio de 2024, recebi uma proposta do Filipe Valentim (@lipe100dedos) para me tornar o desenvolvedor da Nexo Digital e, com muito entusiasmo, aceitei sua proposta. Definimos juntos então o primeiro passo: uma automação de cálculos e pagamentos de recompensas em NEXO para quem delega Hive Power para a conta @nexo.voter.

Conversamos bastante e o @lipe100dedos me explicou como ele já fazia isso manualmente. A ideia dele era automatizar 100% esse processo, desde as consultas à blockchain, os cálculos realizados, os pagamentos efetivos, a geração de planilhas até o envio dessas planilhas para o canal público no servidor de Discord da Nexo Digital.

Após ele tirar diversas dúvidas ao longo dos dias que sucederam a nossa reunião inicial, chegamos então à escolha da linguagem de programação: Python. Uma linguagem rápida, poderosa e escalável, assim como a Hive Blockchain. Escolhemos ela também por ser uma boa linguagem para automações e consumir poucos recursos do servidor.

Depois disso, era hora de definir os passos no desenvolvimento da automação. Definimos então o nosso primeiro algoritmo, contendo passo a passo, na ordem, o que esse robô deveria fazer.

Algoritmo básico inicial:

Verificar e listar em uma planilha todas as contas que delegam Hive Power (HP) para a conta @nexo.voter.
Incluir o HP próprio da conta @nexo.voter (sem considerar as delegações) no topo da lista.
Condensar as contas parceiras em um grupo chamado "Partner Accounts" (somar o total de HP delegado por essas contas).
Definir o total de HP delegado por todas as contas na lista, incluindo o HP próprio da @nexo.voter e o grupo de contas parceiras.
Atribuir 100% ao total definido no passo anterior e calcular um percentual individual para cada conta presente na lista, incluindo o grupo de contas parceiras.
Verificar o HP próprio atual e subtrair o HP próprio anterior (último pagamento calculado) da conta @nexo.voter para definir os ganhos do período.
Determinar, para fins de conferência, quanto seria o pagamento em HIVE para cada conta: (Percentual de HP delegado * ganhos do período) * 2 (já que, segundo o tokenomics criado pelo @lipe100dedos, é possível pagar 200%).
Definir quanto deve ser pago efetivamente em NEXO: Dedução em HIVE (definida no passo anterior) * 0,1 (preço fixo do NEXO definido pelo tokenomics).
Realizar as configurações de chaves privadas (active e posting) e realizar os pagamentos individualmente (ignorando o grupo de contas parceiras e a própria conta nexo.voter).
Gerar a planilha e enviar para o canal público adequado no servidor do Discord da Nexo Digital.
Gerar um log completo e enviar para um canal privado no Telegram, para conferência em caso de bugs, erros e problemas.
Programar uma automação para realizar todos os passos anteriores todos os dias em um horário específico.

Conclusão

Na próxima semana conversaremos um pouco mais a fundo sobre o processo de desenvolvimento dessa automação, as dificuldades encontradas no percurso e como superei essas dificuldades. Fique de olho para não perder nenhuma novidade. Se você tiver dúvidas sobre esse projeto pode comentar esse post, será uma grande satisfação colaborar com você.

Se você quiser conferir o nosso projeto e até mesmo contribuir com o desenvolvimento, acesse aqui. Você pode usar a seção Issues do Github para informar bugs e problemas, além de pode fazer Pull requests para solucionar bugs e realizar novas implementações.

Quer saber como ganhar tokens $NEXO delegando seu HP ou ganhar HBD apenas holdando o token $NEXO? Entre no Discord da Nexo Digital e saiba mais. Vamos espalhar a arte pelas redes!

Sincera e fraternalmente,
Fernando Sousa - @sousafrc

_{Se você quer ler este conteúdo em português, clique aqui.}
_{Si quieres leer este contenido en español, haz clic aquí.}

[EN]

Hey! I hope this post finds you well. I am very happy to introduce myself as the new developer of Nexo Digital. My name is Fernando and you can find me on Hive under the username @sousafrc. Today we are going to talk about the first software developed for the benefit of Hive Power delegators for the Nexo Digital community.

Nowadays, Nexo Digital rewards $NEXO tokens to those who delegate HP. Until now, the payments of these rewards were made manually once a month or every two weeks, depending on the availability of time. Therefore, we have developed an automation with the goal of automatically calculating and paying these rewards daily to our delegators, avoiding human errors and freeing the team to focus on the development and management of the community more effectively.

We are going to trace a kind of timeline that goes from @lipe100dedos' invitation for my participation in the community as a developer, the development process, the difficulties encountered along the way, to what we can expect for the future of Nexo Digital in the context of technology and the development of new tools and software.

The Beginning of the Project

On May 3, 2024, I received a proposal from Filipe Valentim (@lipe100dedos) to become the developer of Nexo Digital and, with great enthusiasm, I accepted his proposal. We then defined the first step together: an automation of calculations and reward payments in NEXO for those who delegate Hive Power to the account @nexo.voter.

We talked a lot and @lipe100dedos explained to me how he was already doing this manually. His idea was to automate this process 100%, from blockchain queries, calculations performed, effective payments, spreadsheet generation to sending these spreadsheets to the public channel on the Nexo Digital Discord server.

After he cleared up several doubts over the days following our initial meeting, we reached the choice of programming language: Python. A fast, powerful, and scalable language, just like the Hive Blockchain. We also chose it because it is a good language for automation and consumes few server resources.

After that, it was time to define the steps in the automation development. We then defined our first algorithm, containing step by step, in order, what this bot should do.

Initial Basic Algorithm:

Check and list in a spreadsheet all accounts that delegate Hive Power (HP) to the account @nexo.voter.
Include the own HP of the account @nexo.voter (without considering delegations) at the top of the list.
Condense partner accounts into a group called "Partner Accounts" (sum the total HP delegated by these accounts).
Define the total HP delegated by all accounts on the list, including the own HP of @nexo.voter and the partner accounts group.
Assign 100% to the total defined in the previous step and calculate an individual percentage for each account on the list, including the partner accounts group.
Check the current own HP and subtract the previous own HP (last calculated payment) from the account @nexo.voter to define the gains of the period.
Determine, for verification purposes, how much the payment in HIVE would be for each account: (Percentage of delegated HP * gains of the period) * 2 (since, according to the tokenomics created by @lipe100dedos, it is possible to pay 200%).
Define how much should be effectively paid in NEXO: Deduction in HIVE (defined in the previous step) * 0.1 (fixed NEXO price defined by the tokenomics).
Configure private keys (active and posting) and make payments individually (ignoring the partner accounts group and the own account nexo.voter).
Generate the spreadsheet and send it to the appropriate public channel on the Nexo Digital Discord server.
Generate a complete log and send it to a private channel on Telegram, for verification in case of bugs, errors, and problems.
Program an automation to perform all the previous steps every day at a specific time.

Conclusion

Next week we will talk more in-depth about the development process of this automation, the difficulties encountered along the way, and how I overcame these difficulties. Stay tuned so you don't miss any news. If you have any questions about this project, you can comment on this post, it will be a great pleasure to collaborate with you.

If you want to check out our project and even contribute to the development, access here. You can use the Issues section on Github to report bugs and problems, as well as make Pull requests to fix bugs and make new implementations.

Do you want to know how to earn $NEXO tokens by delegating your HP or earn HBD just by holding the $NEXO token? Join the Nexo Digital Discord and find out more. Let's spread art through the networks!

Sincerely and fraternally,
Fernando Sousa - @sousafrc

_{Se você quer ler este conteúdo em português, clique aqui.}
_{If you wanna read this content in english, click here.}

[ES]

¡Hola! Espero que esta publicación los encuentre bien. Estoy muy feliz de presentarme como el nuevo desarrollador de Nexo Digital. Me llamo Fernando y pueden encontrarme en Hive con el usuario @sousafrc. Hoy vamos a hablar sobre el primer software desarrollado para el beneficio de los delegadores de Hive Power para la comunidad Nexo Digital.

Hoy en día, Nexo Digital recompensa con tokens $NEXO a quienes delegan HP. Hasta ahora, los pagos de estas recompensas se realizaban manualmente una vez al mes o cada dos semanas, dependiendo de la disponibilidad de tiempo. Por lo tanto, hemos desarrollado una automatización con el objetivo de calcular y pagar automáticamente estas recompensas, diariamente, para nuestros delegadores, evitando errores humanos y liberando al equipo para enfocarse en el desarrollo y gestión de la comunidad de manera más eficaz.

Vamos a recorrer una especie de línea del tiempo que va desde la invitación de @lipe100dedos para mi participación en la comunidad como desarrollador, el proceso de desarrollo, las dificultades encontradas en el camino, hasta lo que podemos esperar para el futuro de Nexo Digital en el contexto de la tecnología y el desarrollo de nuevas herramientas y softwares.

El inicio del proyecto

El día 3 de mayo de 2024, recibí una propuesta de Filipe Valentim (@lipe100dedos) para convertirme en el desarrollador de Nexo Digital y, con mucho entusiasmo, acepté su propuesta. Juntos definimos entonces el primer paso: una automatización de cálculos y pagos de recompensas en NEXO para quienes delegan Hive Power a la cuenta @nexo.voter.

Conversamos bastante y @lipe100dedos me explicó cómo él ya hacía esto manualmente. Su idea era automatizar al 100% este proceso, desde las consultas a la blockchain, los cálculos realizados, los pagos efectivos, la generación de hojas de cálculo hasta el envío de estas hojas al canal público en el servidor de Discord de Nexo Digital.

Después de que él resolviera varias dudas a lo largo de los días que siguieron a nuestra reunión inicial, llegamos a la elección del lenguaje de programación: Python. Un lenguaje rápido, poderoso y escalable, al igual que la blockchain Hive. También la elegimos por ser un buen lenguaje para automatizaciones y consumir pocos recursos del servidor.

Después de esto, era hora de definir los pasos en el desarrollo de la automatización. Definimos entonces nuestro primer algoritmo, que contenía paso a paso, en orden, lo que este robot debería hacer.

Algoritmo básico inicial:

Verificar y listar en una hoja de cálculo todas las cuentas que delegan Hive Power (HP) a la cuenta @nexo.voter.
Incluir el HP propio de la cuenta @nexo.voter (sin considerar las delegaciones) en la parte superior de la lista.
Agrupar las cuentas asociadas en un grupo llamado "Partner Accounts" (sumar el total de HP delegado por estas cuentas).
Definir el total de HP delegado por todas las cuentas en la lista, incluyendo el HP propio de @nexo.voter y el grupo de cuentas asociadas.
Asignar el 100% al total definido en el paso anterior y calcular un porcentaje individual para cada cuenta presente en la lista, incluyendo el grupo de cuentas asociadas.
Verificar el HP propio actual y restar el HP propio anterior (último pago calculado) de la cuenta @nexo.voter para definir las ganancias del período.
Determinar, para fines de verificación, cuánto sería el pago en HIVE para cada cuenta: (Porcentaje de HP delegado * ganancias del período) * 2 (ya que, según el tokenomics creado por @lipe100dedos, es posible pagar el 200%).
Definir cuánto debe pagarse efectivamente en NEXO: Deducción en HIVE (definida en el paso anterior) * 0,1 (precio fijo del NEXO definido por el tokenomics).
Realizar las configuraciones de claves privadas (active y posting) y realizar los pagos individualmente (ignorando el grupo de cuentas asociadas y la cuenta propia @nexo.voter).
Generar la hoja de cálculo y enviarla al canal público adecuado en el servidor de Discord de Nexo Digital.
Generar un log completo y enviarlo a un canal privado en Telegram, para verificación en caso de bugs, errores y problemas.
Programar una automatización para realizar todos los pasos anteriores todos los días en un horario específico.

Conclusión

La próxima semana hablaremos más a fondo sobre el proceso de desarrollo de esta automatización, las dificultades encontradas en el camino y cómo superé esas dificultades. Mantente atento para no perderte ninguna novedad. Si tienes dudas sobre este proyecto, puedes comentar en esta publicación, será un gran placer colaborar contigo.

Si quieres revisar nuestro proyecto e incluso contribuir con el desarrollo, accede aquí. Puedes usar la sección Issues de Github para informar bugs y problemas, además de hacer Pull requests para solucionar bugs y realizar nuevas implementaciones.

¿Quieres saber cómo ganar tokens $NEXO delegando tu HP o ganar HBD simplemente manteniendo el token $NEXO? Entra en el Discord de Nexo Digital y entérate de más. ¡Vamos a esparcir el arte por las redes!

Sinceramente y fraternalmente,
Fernando Sousa - @sousafrc