<img src="https://files.peakd.com/file/peakd-hive/codebydoble/ALEaXzCvKgJW4mQD5N3tTQUvdNrHom9Ay3aAZtjvnwkB7hP8KpsHNRMntH918Va.png" alt="Poster feature convert">

On May 19, 2024, the article <a href="https://peakd.com/hive-10053/@hivecuba/hive-cuba-p2p-open-source">Hive Cuba's P2P opens to everyone - Open Source</a> was published in the Hive Cuba Community. The HiveCubaP2P project code was released on <a href="https://github.com/Ertytux/Hive_P2P_Bot">Github</a> under the MIT license. This release allowed developers to contribute to the development, maintenance and factorization of the project code.


<blockquote>
El 19 de mayo de 2024 se publicó en la Comunidad de Hive Cuba el artículo <a href="https://peakd.com/hive-10053/@hivecuba/hive-cuba-p2p-open-source">El P2P de Hive Cuba se abre a todos - OpenSource</a>. El código del proyecto HiveCubaP2P fue liberado en <a href="https://github.com/Ertytux/Hive_P2P_Bot">Github</a> bajo la licencia MIT. Esta liberación permitió a los desarrolladores contribuir al desarrollo, mantenimiento y factorización del código del proyecto.
</blockquote>

<a href="https://t.me/HiveCuBaP2P_Bot">HiveCubaP2P</a> 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 @hivecuba.p2p account trusted and supported by the HIVE Cuba community. It has zero commissions for users who have a subscription delegation.<br>

<div class="pull-right">
<a href="https://peakd.com/@ertytux">Ertytux</a>
</div>
<br>


<blockquote>
<a href="https://t.me/HiveCuBaP2P_Bot">HiveCubaP2P</a> 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 @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.<br>
<div class="pull-right">
<a href="https://peakd.com/@ertytux">Ertytux</a>
</div>
<br>
</blockquote>

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.


<blockquote>
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.
</blockquote>

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


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

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 <a href="https://github.com/Ertytux/Hive_P2P_Bot/blob/main/README.md">README.md</a>

<h2>Guideline</h2>

<ul>
<li>Cloning the Bot project</li>
</ul>

<pre>
git clone https://github.com/Ertytux/Hive_P2P_Bot.git
</pre>

<ul>
<li>Create an exclusive virtual environment</li>
</ul>

<pre>
cd Hive_P2P_Bot
python3 -m venv env
</pre>

<ul>
<li>Activate the virtual environment</li>
</ul>

<pre>
Windows
env\Scripts\activate

macOS or Linux
env/bin/activate
</pre>

<ul>
<li>Install the packages from the requirements.txt file</li>
</ul>

<pre>
pip install -r requeriment.txt
</pre>

<ul>
<li>Have an account in HIVESQL</li>
</ul>
<ul>
<li>Run and setup into operations the bot with the command:</li>
</ul>

<pre>
Linux or macOS
./run.sh

Windows
call .env_sample.bat
</pre>


<blockquote>
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 <a href="https://github.com/Ertytux/Hive_P2P_Bot/blob/main/README.md">README.md</a>
</blockquote>

<h2>Guía</h2>

<ul>
<li>Clonar el proyecto Bot</li>
</ul>

<pre>
git clone https://github.com/Ertytux/Hive_P2P_Bot.git
</pre>

<ul>
<li>Crear un entorno virtual exclusivo</li>
</ul>

<pre>
cd Hive_P2P_Bot
python3 -m venv env
</pre>

<ul>
<li>Activar el entorno virtual</li>
</ul>

<pre>
Windows
env\Scripts\activate

macOS o Linux
env/bin/activate
</pre>

<ul>
<li>Instalar los paquetes desde el archivo requirements.txt</li>
</ul>

<pre>
pip install -r requeriment.txt
</pre>

<ul>
<li>Tener una cuenta en HIVESQL</li>
</ul>
<ul>
<li>Ejecutar y configurar el bot en operaciones con el comando:</li>
</ul>

<pre>
Linux o macOS
./run.sh

Windows
call .env_sample.bat
</pre>

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

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

<figure>
<img src="https://files.peakd.com/file/peakd-hive/codebydoble/23tRt96iGU7F4kkLrgeHfaVs8wSYmUCLFs4CX6RaXteY6wR1b72CQkH2RsmCPf8PsWCa8.png" alt="Hive Cuba Project structure">
<figcaption>HiveCubaP2P project structure</figcaption>
</figure>

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.


<blockquote>
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.
</blockquote>

<pre>
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
</pre>

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 <h3>Structure</h3>/convert 1 HBD CUP


<blockquote>
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 <h3>Estructura</h3> /convert 1 HBD CUP
</blockquote>

<pre>
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]))
</pre>

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.


<blockquote>
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.
</blockquote>


<pre>
application.add_handler(CommandHandler("convert", convert))
</pre>

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


<blockquote>
Finalmente, la nueva funcionalidad se describe en el archivo messages.py
</blockquote>

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

<h2>Telegram bot /convert feature</h2>
<figure><img src="https://files.peakd.com/file/peakd-hive/codebydoble/23tS32RnmikAYy6h7RxzKerYYn3nvdepeHUcpNQSe1S3QaoHdQK1xJVk1mgingyahdcqe.jpeg" alt="Example convert feature">
<figcaption>HiveCubaP2P /convert</figcaption>
</figure>

<figure>
<img src="https://files.peakd.com/file/peakd-hive/codebydoble/23swigprGq8xwsn9WJy4BZrNUQTZSoeZ3EGWXSWMaLsSoU4HMTxU3qj7c5xT5sTjvghjQ.png" alt="Api yadio">
<figcaption>Yadio api</figcaption>
</figure>

<figure>
<img src="https://files.peakd.com/file/peakd-hive/codebydoble/23t79CDinbUhmjtdXM54thoebDzCuBFRBgyGh3tjCtXzpECBYB2Pn9fNRxXLtNbvvRHz8.png" alt="Coin Price by IDs">
<figcaption>Coingecko api</figcaption>
</figure>


<img src="https://files.peakd.com/file/peakd-hive/codebydoble/23tGPXhp1eehgFZSZMN7rgxg9sC8yKNfdGV8tKuLiLYkqqrQsj7mTFH8dyhCHqzeMcKaU.png" alt="Hive Cuba divisor">

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.

<blockquote>
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.
</blockquote>

<img src="https://files.peakd.com/file/peakd-hive/codebydoble/23vsou3gvqf61DgDgvgtS57RLLYFT4nrF9pE25tnFny6LCRaNRr6tHzYWgLKAc5socvtU.png" alt="Banner codebydoble">


<img src="https://files.peakd.com/file/peakd-hive/codebydoble/23t8EsVYvXZBMsxfq42GaCLyMHWWPbidH3t9HzaaWbabptLtSrsfGLbQ6Fo2Lew11KnA6.gif" alt="Gif HiveCuba">