Hive Cuba P2P: /convert a new feature [EN/ES]

On May 19, 2024, the article Hive Cuba's P2P opens to everyone - Open Source was published in the Hive Cuba Community. The HiveCubaP2P project code was released on Github under the MIT license. This release allowed developers to contribute to the development, maintenance and factorization of the project code.

El 19 de mayo de 2024 se publicó en la Comunidad de Hive Cuba el artículo El P2P de Hive Cuba se abre a todos - OpenSource. El código del proyecto HiveCubaP2P fue liberado en Github bajo la licencia MIT. Esta liberación permitió a los desarrolladores contribuir al desarrollo, mantenimiento y factorización del código del proyecto.

HiveCubaP2P is a Telegram bot for P2P peer-to-peer exchange of HIVE or HBD with FIAT or other values. It is based on a mechanism of escrow guaranteed by the Hive account@hivecuba.p2p account trusted and supported by the HIVE Cuba community. It has zero commissions for users who have a subscription delegation.

HiveCubaP2P es un bot de Telegram para el intercambio P2P peer-to-peer de HIVE o HBD con FIAT u otros valores. Se basa en un mecanismo de depósito en garantía garantizado por la cuenta Hive account@hivecuba.p2p, de confianza y con el respaldo de la comunidad HIVE Cuba. Tiene cero comisiones para los usuarios que tengan una delegación de suscripción.

Ertytux

Reading your roadmap, I understand that, although it is a project that is consolidating and is used and accepted by the Cuban Hive community, it still needs developers to evolve and make the access curve much simpler.

Leyendo su roadmap comprendo que, aunque es un proyecto que se consolida y es utilizado y aceptado por la comunidad cubana de Hive aún necesita de desarrolladores para evolucionar y que la curva de acceso sea mucho más sencilla.

Roadmap

• Collaborate with other communities.
• Add support for Sats via Hive account@v4vapp
• Add new functionalities and information elements to users.
• Implement buttons to improve usability.
• Implement a way to keep the exchange inside the bot always.
• Create a webapp that frees us from depending on Telegram.
• Add new languages if necessary.
• Add other collateral services and promote community services in favor of the adoption of HIVE/HBD/SAT.

Roadmap

• Colaborar con otras comunidades.
• Añadir soporte para Sats vía Hive account@v4vapp
• Añadir nuevas funcionalidades y elementos de información a los usuarios.
• Implementar botones para mejorar la usabilidad.
• Implementar una forma de mantener el intercambio dentro del bot siempre.
• Crear una webapp que nos libere de depender de Telegram.
• Añadir nuevos idiomas si es necesario.
• Añadir otros servicios colaterales y promover servicios comunitarios a favor de la adopción de HIVE/HBD/SAT.

One of the functionalities that are recurrent in P2P exchange bots is to integrate a currency converter that allows you to see updated prices or calculate the estimated conversion from one currency to another without leaving Telegram.
I got to work by making a fork of the project on Github. To do this, I followed the collaboration guide in the README.md

Guideline

• Cloning the Bot project

git clone https://github.com/Ertytux/Hive_P2P_Bot.git

• Create an exclusive virtual environment

cd Hive_P2P_Bot
python3 -m venv env

• Activate the virtual environment

Windows
env\Scripts\activate
macOS or Linux

env/bin/activate

• Install the packages from the requirements.txt file

pip install -r requeriment.txt

• Have an account in HIVESQL

• Run and setup into operations the bot with the command:

Linux or macOS
./run.sh
Windows

call .env_sample.bat

Una de las funcionalidades que son recurrentes en los bots de intercambio P2P es la de integrar un conversor de divisas que permite ver precios actualizados o calcular la conversión estimada de una moneda a otra sin salir de Telegram. Me puse manos a la obra haciendo un fork del proyecto en Github. Para ello, seguí la guía de colaboración en el archivo README.md

Guía

• Clonar el proyecto Bot

git clone https://github.com/Ertytux/Hive_P2P_Bot.git

• Crear un entorno virtual exclusivo

cd Hive_P2P_Bot
python3 -m venv env

• Activar el entorno virtual

Windows
env\Scripts\activate
macOS o Linux

env/bin/activate

• Instalar los paquetes desde el archivo requirements.txt

pip install -r requeriment.txt

• Tener una cuenta en HIVESQL

• Ejecutar y configurar el bot en operaciones con el comando:

Linux o macOS
./run.sh
Windows

call .env_sample.bat

A new feature in the project consists of modifying the files: rates.py, botengine.py, hcp2pb.py, messages.py

Una nueva característica del proyecto consiste en modificar los archivos: rates.py, botengine.py, hcp2pb.py, messages.py

HiveCubaP2P project structure

In the rates.py file, the function that is responsible for receiving the amount to be exchanged and the source and destination currencies is added. The currencies available for conversion through APIs (Yadio and Coingecko) are: CUP, USD, MLC, HBD and Hive.

En el archivo rates.py se agrega la función que se encarga de recibir el monto a cambiar y las monedas de origen y destino. Las monedas disponibles para conversión a través de APIs (Yadio y Coingecko) son: CUP, USD, MLC, HBD y Hive.

def getExchange(amount:str, coinFrom:str, coinTo:str)->str:
    """
    Convert an amount from one currency to another\n
    Currency: USD, CUP, MLC, HIVE, HBD
    """
    try:
        # response = requests.get(yadio_url)
        urlYadio = 'https://api.yadio.io/convert/'
        urlYadioRate = 'https://api.yadio.io/exrates/USD'
        divisorSlash = '/'
        if (coinFrom.upper() in tkY and coinTo.upper() in tkY):
            """Exchange Yadio CUP MLC USD from Yadio"""
            convertUrlYadio = f"{urlYadio}{amount}{divisorSlash}{coinFrom.upper()}{divisorSlash}{coinTo.upper()}"
            response = requests.get(convertUrlYadio)
            result = response.json().get('result')
            rate = response.json().get('rate')
            msg = f"Amount {coinTo.upper()}: {result:.8f} {coinTo.upper()}\nRate: {rate:.8f} USD"
            # return exchange_result
        elif (coinFrom.upper() in tkG and coinTo.upper() in tkG and coinFrom.upper() != coinTo.upper()):
            """Exchange HBD/Hive from Coingecko"""
            idxFrom = tkG.get(coinFrom.upper())
            idxTo = tkG.get(coinTo.upper())
            if idxFrom == 'hive':
                """Exchange Hive to HBD from Coingecko""" 
                pHive=float(cg.get_price(ids=idxFrom, vs_currencies='usd')[idxFrom]['usd'])
                vHive=float(amount)*pHive
                pHBD=float(cg.get_price(ids=idxTo, vs_currencies='usd')[idxTo]['usd'])
                result=vHive/pHBD
                msg = f"Amount {coinTo.upper()}: {result:.8f} {coinTo.upper()}\nRate: {pHBD:.8f} USD"
                #return exchange_result
            else:
                """Exchange HBD to Hive from Coingecko"""
                pHBD=float(cg.get_price(ids=idxFrom, vs_currencies='usd')[idxFrom]['usd'])
                vHBD=float(amount)*pHBD
                pHive=float(cg.get_price(ids=idxTo, vs_currencies='usd')[idxTo]['usd'])
                result=vHBD/pHive
                msg = f"Amount {coinTo.upper()}: {result:.8f} {coinTo.upper()}\nRate: {pHive:.8f} USD"
                # return exchange_result
        elif (coinFrom.upper() in tkY and coinTo.upper() in tkG):
            """Exchange from Yadio to Coingecko"""
            response = requests.get(urlYadioRate)
            pcoin=float(response.json().get('USD').get(coinFrom.upper()))
            vcoin=float(amount)/pcoin
            idxTo = tkG.get(coinTo.upper())
            pcoinGecko=float(cg.get_price(ids=idxTo, vs_currencies='usd')[idxTo]['usd'])
            result=vcoin/pcoinGecko
            msg = f"Amount {coinTo.upper()}: {result:.8f} {coinTo.upper()}\nRate: {pcoinGecko:.8f} USD"
        elif (coinFrom.upper() in tkG and coinTo.upper() in tkY):
            """Exchange from Coingecko to Yadio"""
            response = requests.get(urlYadioRate)
            idxFrom = tkG.get(coinFrom.upper())
            pcoinGecko=float(cg.get_price(ids=idxFrom, vs_currencies='usd')[idxFrom]['usd'])
            vcoin=float(amount)*pcoinGecko
            pcoin=float(response.json().get('USD').get(coinTo.upper()))
            result=vcoin*pcoin
            msg = f"Amount {coinTo.upper()}: {result:.8f} {coinTo.upper()}\nRate: {pcoin:.8f} USD"
        else:
            msg=f"No es posible realizar esa conversión\nIt is not available this exchange!!!"
    except:
        msg=f"No esta disponible\nIt is not available!!!"
    return msg

In the botengine.py file, the convert() function is created that captures the amount of the source currency and the currency to be obtained from the bot front-end using the structure

Structure

/convert 1 HBD CUP

En el archivo botengine.py, se crea la función convert() que captura la cantidad de la moneda de origen y la moneda a obtener desde el front-end del bot utilizando la estructura

Estructura

/convert 1 HBD CUP

async def convert(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    """Convert an amount from one currency to another command /convert\n
    Command: /convert 1 HBD CUP
    """
    user = update.effective_user
    scode = getlang(user.language_code)
    if user.username == '' or user.username == None:
        await update.message.reply_markdown(messages_statU.get(scode))
        return None
    stext = update.message.text.split()
    if len(stext) < 4:
        msg = {'es': 'Comando incorrecto, debe ser por ejemplo: /convert 1 HBD CUP ',
               'en': 'Incorrect command, it must be for example: /convert 1 HBD CUP '}
        await update.message.reply_text(msg.get(scode))
        return None
    await update.message.reply_text(rt.getExchange(stext[1],stext[2],stext[3]))

In the hcp2pb.py file, the handler in charge of displaying the new command /convert application.add_handler(CommandHandler("convert", convert)) in the telegram bot is added.

En el archivo hcp2pb.py, se agrega el controlador encargado de mostrar el nuevo comando /convert application.add_handler(CommandHandler("convert", convert)) en el bot de Telegram.

application.add_handler(CommandHandler("convert", convert))

Finally, the new functionality is described in the messages.py file

Finalmente, la nueva funcionalidad se describe en el archivo messages.py

/convert - Convert an amount from one currency to another 🧮

Telegram bot /convert feature

HiveCubaP2P /convert Yadio api Coingecko api

Well, that's all for this post. I hope this feature has been useful to you. Let me know if you want to see any other new features added.

Bueno, y hasta aquí el post, espero que esta funcionalidad te haya sido útil. Cuéntame si deseas que se agregue alguna otra nueva funcionalidad.