Add FAQ to docs

* Add FAQ to docs
* Move images to new images directory
* Update links to images on INSTALL docs

docs/FAQ.es.md

@@ -0,0 +1,206 @@
+# Preguntas de uso frecuente
+
+1. ¿Qué es LNP2Pbot?
+
+LNP2PBOT es un intercambio persona a persona, de código abierto, no custodio, sin registro de usuario ni verificación de identidad, que funciona sobre un bot de Telegram y permite comprar y vender sats (unidad de medida mínima en fracciones de Bitcoin) a través de Ligthning Network.
+
+
+2. ¿Qué es Lightning Network?
+
+Ligthning Network es una red de canales de pago que funciona como protocolo de segunda capa sobre la red Bitcoin, aprovechando la propiedad de escribir contratos inteligentes en su blockchain. Es una solución de escalabilidad que permite incrementar exponencialmente el número de transacciones y la velocidad de las mismas al no necesitar confirmaciones on-chain, a su vez que reducir drásticamente las comisiones de red. Los pagos se vuelven instantáneos y de costo casi nulo.
+
+
+3. ¿Qué necesito para usar LNP2Pbot?
+
+Solo necesitas una cuenta de Telegram con el "username" activado, inicializar el bot y una Wallet que soporte Ligthning Network (Acá te dejamos algunas sugerencias LINK A FAQ MEDIOS DE PAGO Y WALLETS RECOMENDADAS).
+
+4. ¿Cómo inicializo el bot?
+
+Escríbele en privado a [@lnp2pbot](https://t.me/lnp2pbot) y ejecuta el comando `/start`.
+
+5. ¿Cuáles son los canales para realizar intercambios en telegram?
+
+Para crear tus órdenes de compra / venta escríbele a [@lnp2pbot](https://t.me/lnp2pbot).
+
+Para tomar ofertas de compra / venta ingresa al canal [@p2plightning](https://t.me/p2plightning).
+
+6. ¿Necesito llenar algún registro de usuario o verificación de identidad?
+
+¡NO! Bitcoin nació como "un sistema de dinero electrónico persona a persona" y nos enorgullece apoyar ese principio. Ningún dato personal te es requerido, los intercambios son totalmente entre pares y LNP2PBot no recopila ni almacena ninguna información personal de las partes implicadas.
+
+7. ¿Qué tipo de información recopilan de cada usuario?
+
+Para efectos del sistema de reputación de usuario, solo la cantidad de transacciones concretadas, el volumen total comerciado, la calificación de contraparte, y el score de disputas en caso de incurrir en alguna. De esta información, solo es pública por defecto la cantidad de transacciones y la calificación de contraparte, y opcional (tu eliges mostrarlo o no, por defecto no se muestra) el volumen total comerciado y tu username.
+
+En caso de que desees mostrar tu nombre de usuario y/o volumen comerciado para acompañar tu reputación en las ofertas que publicas, deberás hacerlo manualmente a través de los siguientes comandos:
+```
+/showusername yes
+
+/showvolume yes
+```
+Cada comando se le envía como un mensaje directo al bot.
+
+8. ¿Cómo funciona el sistema de reputación de usuario?
+
+Por cada transacción que realices, se te pedirá calificar a tu contraparte, a la vez que este te calificará a ti.
+
+
+9. ¿Cómo creo una orden de compra?
+
+Al conversar con el bot [@lnp2pbot](https://t.me/lnp2pbot) encontrarás un botón de menú que te indicará los siguientes comandos:
+
+Escribes `/buy <monto en sats> <monto en fiat> <código fiat> <método de pago> [prima/descuento]` sin los carácteres especiales
+
+Ej. `/buy 100000 50 usd "banco xyz"`
+(Compro cien mil sats a cincuenta dólares pago por banco xyz)
+
+Ej. `/buy 0 50 ves "banco xyz"`
+(Compro cincuenta bolívares en sats -en este caso el bot hará el cálculo a la tasa de mercado- pago por banco xyz)
+
+Ej. `/buy 0 10-100 pen "pago móvil"`
+(Compro de 10 a 100 nuevos soles -en este caso el vendedor elegirá que monto venderte en ese rango- pago por pago móvil)
+
+Ej. `/buy 0 100 eur -3 "pago móvil"`
+(Compro 100 euros descontando 3% -en este caso el bot hará el cálculo a la tasa de mercado descontando o incrementando el porcentaje que elijas- pago por pago móvil)
+
+De haber alguna variable no compatible el bot te lo indicará durante el proceso de creación de orden. Al completarla, la misma se publicará automáticamente en el canal de intercambio y será visible por un período de 23 horas.
+
+10. ¿Cómo creo una orden de venta?
+
+El procedimiento es exactamente el mismo a la orden de compra, sustituyendo el comando `/buy` por `/sell`
+
+El bot tiene un botón de menú que te indicará los siguientes comandos:
+
+Escribes `/sell <monto en sats> <monto en fiat> <código fiat> <método de pago> [prima/descuento]` sin los carácteres especiales
+
+Ej. `/sell 100000 50 usd "banco xyz"` **Vendo cien mil sats a cincuenta dólares cobro por banco xyz**
+
+Ej. `/sell 0 50 ves "banco xyz"` **Vendo cincuenta bolívares en sats -en este caso el bot hará el cálculo a la tasa de mercado- cobro por banco xyz**
+
+Ej. `/sell 0 10-100 pen "banco xyz"` **Vendo de 10 a 100 nuevos soles -en este caso el comprador elegirá que monto comprarte en ese rango- cobro por pago móvil**
+
+Ej. `/sell 0 100 eur bizum 3` **Vendo 100 euros incrementando 3% -en este caso el bot hará el cálculo a la tasa de mercado incrementando el porcentaje que elijas- cobro por bizum**
+
+De haber alguna variable no compatible el bot te lo indicará durante el proceso de creación de orden. Al completarla, la misma se publicará en el canal de intercambio y será visible por un período de 23 horas.
+
+11. ¿Cómo busco y acepto una oferta de compra o venta?
+
+En el canal [@p2plightning](https://t.me/p2plightning) encontrarás publicadas las ofertas de todos los participantes, incluídas las tuyas. Simplemente revísalo hasta encontrar alguna que se adapte a tu búsqueda y pulsa el botón "comprar satoshis" o "vender satoshis"
+
+11. ¿Cómo cancelo una orden publicada?
+
+Si la orden no ha sido tomada, simplemente utilizas el comando `/cancel <orden id>` en tu chat con el bot
+
+El ID o número identificador de tu orden aparece justo debajo del mensaje de aceptación y publicación de la misma, e incluso, se te indica como opción para cancelarla.
+
+Si la orden ha sido tomada, deberás iniciar una cancelación cooperativa.
+
+12. ¿Hay límites mínimos o máximos en las cantidades que puedo transar?
+
+Desde el bot, no hay límites para el volumen de tu transacción. Sin embargo, dependerá de la capacidad de la red y la liquidez del canal que puedas en determinado momento encontrar un límite máximo.
+
+
+13. ¿Cuánto tiempo toma concretar una transacción?
+
+Depende de varios factores. Por ser un intercambio P2P, el principal es la toma de tu oferta por un contraparte. Tu publicación estará disponible hasta por 23 horas y luego será automáticamente eliminada si la misma no es tomada.
+
+Una vez aceptada una oferta, se abre una ventana de tiempo de 15 minutos para pagar la factura ligthning y que el bot ponga en contacto a ambas partes. A partir de acá, tienen un tiempo máximo de dos horas para concretar la operación, ya que al expirar, los sats serán devueltos a la wallet de procedencia, por esta razón los usuarios deben utilizar únicamente medios de pago de dinero fiat instantáneos.
+
+Al estar ambos participantes en línea y acordar métodos de pago inmediatos, las transacciones son casi instantáneas.
+
+14. ¿Tarifas y comisiones?
+
+El bot cobra una tasa fija de 0,6%, que incluye la tarifa de red, por lo que no hay cobros adicionales. Esta comisión la paga solo el vendedor, no el comprador.
+
+15. ¿Qué tasa de cambio utiliza el bot?
+
+Al crear una orden sin especificar la cantidad en sats que deseas comprar/vender, sino el monto fiat a pagar/cobrar, el bot hará el cálculo a tasa de mercado ofrecida por [yadio.io](https://yadio.io)
+
+16. ¿En qué países está disponible?
+
+Al ser un intercambio P2P sobre telegram, técnicamente está disponible para todo el que tenga esta app. Sin embargo, hasta el momento el bot interactúa con un listado de 58 monedas con las que puedes crear órdenes de compra/venta.
+
+Acá te dejamos el listado
+
+Code | Name | |
+|---|---|---|
+AED | United Arab Emirates Dirham | 🇦🇪
+ARS | Peso argentino | 🇦🇷
+AUD | Australian Dollar | 🇦🇺
+AZN | Azerbaijani Manat | 🇦🇿
+BOB | Boliviano | 🇧🇴
+BRL | Brazilian Real | 🇧🇷
+BYN | Belarusian Ruble | 🇧🇾
+CHF | Swiss Franc | 🇨🇭
+CAD | Canadian Dollar | 🇨🇦
+CLP | Peso chileno | 🇨🇱
+CNY | Chinese Yuan | 🇨🇳
+COP | Peso colombiano | 🇨🇴
+CRC | Colón | 🇨🇷
+CUP | Peso cubano | 🇨🇺
+CZK | Czech Republic Koruna | 🇨🇿
+DKK | Danish Krone | 🇩🇰
+DOP | Peso dominicano | 🇩🇴
+EUR | Euro | 🇪🇺
+GBP | British Pound Sterling | 🇬🇧
+GHS | Ghanaian Cedi | 🇬🇭
+GTQ | Quetzal | 🇬🇹
+HKD | Hong Kong Dollar | 🇭🇰
+HUF | Hungarian Forint | 🇭🇺
+IDR | Indonesian Rupiah | 🇮🇩
+ILS | Israeli New Sheqel | 🇮🇱
+INR | Indian Rupee | 🇮🇳
+JMD | Jamaican Dollar | 🇯🇲
+JPY | Japanese Yen | 🇯🇵
+KES | Kenyan Shilling | 🇰🇪
+KRW | South Korean Won | 🇰🇷
+KZT | Kazakhstani Tenge | 🇰🇿
+MXN | Peso mexicano | 🇲🇽
+MYR | Malaysian Ringgit | 🇲🇾
+NAD | Namibian Dollar | 🇳🇦
+NGN | Nigerian Naira | 🇳🇬
+NOK | Norwegian Krone | 🇳🇴
+NZD | New Zealand Dollar | 🇳🇿
+PAB | Panamanian Balboa | 🇵🇦
+PEN | Peruvian Nuevo Sol | 🇵🇪
+PHP | Philippine Peso | 🇵🇭
+PKR | Pakistani Rupee | 🇵🇰
+PLN | Polish Zloty | 🇵🇱
+PYG | Paraguayan Guarani | 🇵🇾
+QAR | Qatari Rial | 🇶🇦
+RON | Romanian Leu | 🇷🇴
+RUB | Russian Ruble | 🇷🇺
+SAR | Saudi Riyal | 🇸🇦
+SEK | Swedish Krona | 🇸🇪
+SGD | Singapore Dollar | 🇸🇬
+TRY | Turkish Lira | 🇹🇷
+TTD | Trinidad and Tobago Dollar | 🇹🇹
+UAH | Ukrainian Hryvnia | 🇺🇦
+USD | US Dollar | 🇺🇸
+USDSV | USD en El Salvador | 🇺🇸🇸🇻
+USDVE | USD en Bs | 🇺🇸🇻🇪
+UYU | Peso uruguayo | 🇺🇾
+VES | Bolívar | 🇻🇪
+VND | Vietnamese Dong | 🇻🇳
+ZAR | South African Rand | 🇿🇦
+
+17. Wallets recomendadas
+
+Las siguientes Wallets son las que han demostrado un mejor rendimiento al testearlas con el bot
+
+* [Muun Wallet](https://muun.com/es/)
+* [Blue Wallet](https://bluewallet.io/)
+* [Phoenix Wallet](https://phoenix.acinq.co/)
+* [@lntxbot](https://t.me/lntxbot)
+
+18. Soporte
+
+@lnp2pbot no es una empresa, por ello no cuenta con un departamento de soporte técnico, aunque sí hay una comunidad a la que puedes acudir en caso de que necesites ayuda, recuerda que los participantes en esta comunidad no reciben ningún tipo de remuneración, si no recibes respuesta inmediata, se paciente y educado que si alguien tiene la respuesta en algún momento intentará ayudarte.
+
+19. Contacto con desarrolladores
+
+Si necesitas contactarse con los desarrolladores utiliza nuestro github, si tienes alguna propuesta o quieres reportar un bug ve a la sección de issues y crea uno.
+
+20. Soy desarrollador y quiero contribuir
+
+¡Genial! gracias por tu interés, en la sección de issues podrás ver una lista de issues por resolver, elige uno con etiqueta [help wanted](https://github.com/grunch/p2plnbot/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) y si tienes dudas puedes preguntar haciendo un comentario y luego si estás seguro de que quieres resolverlo coméntalo, los que tienen etiqueta [good first issue](https://github.com/grunch/p2plnbot/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) son issues sencillos que muchas veces sirven para familiarizarte con el código.

docs/INSTALL.es.md

@@ -34,7 +34,7 @@ Llegar a todos los usuarios que requieran adquirir satoshis de Bitcoin sin custo
 1) Computadora con acceso a internet. 
 2) Sistema de gestión de nodos [Polar.](https://lightningpolar.com/)
 
-![polar](polar.jpg)
+![polar](images/polar.jpg)
 
 
 3) [Docker](https://www.docker.com/): automatización de implementación de aplicaciones como contenedores portátiles y autosuficientes que se pueden ejecutar en la nube o localmente.
@@ -157,7 +157,7 @@ $ vi .env
 
 * Si está usando Polar los datos los obtiene como se muestra en la siguiente imagen:
 
-![polarVariables](polarVariables.jpg)
+![polarVariables](images/polarVariables.jpg)
 
 
 **LND_GRPC_HOST:** dirección IP o el nombre de dominio desde el nodo LND y el puerto separado por dos puntos, ej: `192.168.0.2:10009.`
@@ -170,7 +170,7 @@ o de token que es que se colocará en este campo.
 
 **ADMIN_CHANNEL:** Este dato será el ID de su canal, para obtenerlo escriba un mensaje en su canal, reenvíelo al bot `@JsonDumpBot` y le mostrara un JSON con el ID del canal. 
 
-![telegram_bot](telegram_bot.jpg)
+![telegram_bot](images/telegram_bot.jpg)
 
 * Más información [aquí.](https://gist.github.com/mraaroncruz/e76d19f7d61d59419002db54030ebe35)
 
@@ -223,69 +223,69 @@ $ npm test
 
 Mostrará un menú, elegiremos la opción de `/sell` para vender con los requerimientos necesarios.
 
-![telegram](telegram.jpg)
+![telegram](images/telegram.jpg)
 
 2) En el canal se verá la oferta, debe elegir comprar con el otro usuario de Telegram.
 
-![oferta](oferta.jpg)
+![oferta](images/oferta.jpg)
 
 3) Tomar la orden en el canal. Dar clic en Comprar Satoshis.
 
-![tomar_orden](tomar_orden.jpg)
+![tomar_orden](images/tomar_orden.jpg)
 
 4) Entrar al bot y dar clic en continuar.
 
-![bot_continuar](bot_continuar.jpg)
+![bot_continuar](images/bot_continuar.jpg)
 
 Este mensaje es el que se le mostrará.
 
-![bot_tomar_oferta](bot_tomar_oferta.jpg)
+![bot_tomar_oferta](images/bot_tomar_oferta.jpg)
 
 5) Crear factura en Polar con algunos de los usuarios y pegar en Telegram. Elegir `Crear Factura` en la parte de comportamiento.
 
-![crear_factura](crear_factura.jpg)
+![crear_factura](images/crear_factura.jpg)
 
 6) Poner la cantidad de venta. 
 
-![cantidad](cantidad.jpg)
+![cantidad](images/cantidad.jpg)
 
 7) Elegir `copiar y Cerrar.`
 
-![copiar_factura](copiar_factura.jpg)
+![copiar_factura](images/copiar_factura.jpg)
 
 8) Entrar al `bot` y pegar la factura. 
 
-![factura](factura.jpg)
+![factura](images/factura.jpg)
 
 Llegará una solicitud de pago al vendedor que se verá en el `bot.`
 
-![solicitud](solicitud.jpg)
+![solicitud](images/solicitud.jpg)
 
 9) Pegar la factura en Polar y pagarla. 
 
-![pagar](pagar.jpg)
+![pagar](images/pagar.jpg)
 
 10) Cuando alguien tome la orden, el `bot` mostrará el siguiente mensaje:
 
-![solicitud_de_pago](solicitud_de_pago.jpg)
+![solicitud_de_pago](images/solicitud_de_pago.jpg)
 
 11) En el `bot` para el otro usuario se mostrará lo siguiente:
 
-![tomar_orden_venta](tomar_orden_venta.jpg)
+![tomar_orden_venta](images/tomar_orden_venta.jpg)
 
 12) El usuario debe liberar los fondos con el comando `/fiatsent`, para ello debe copiar y pegar con el `id`
 
-![fiatsent](fiatsent.jpg)
+![fiatsent](images/fiatsent.jpg)
 
 13) El `bot` indicará que el usuario ya envió el dinero fiat.
 
-![confirmar_envio](confirmar_envio.jpg)
+![confirmar_envio](images/confirmar_envio.jpg)
 
 
 14) El usuario debe liberar los fondos con el comando `/release`, para ello debe copiar y pegar con el `id`
 
-![release](release.jpg)
+![release](images/release.jpg)
 
 15) Finalmente se le avisará al comprador que su operación ha sido completada con éxito.
 
-![compra_exiosa](compra_exiosa.jpg)
+![compra_exiosa](images/compra_exiosa.jpg)