LNbits - La navaja suiza de la infraestructura

LNbits es una solución de billetera y sistema de cuentas que se ejecuta sobre un nodo LND, permitiendo segmentar fondos y habilitar funcionalidades extendidas mediante extensiones. Es el motor que procesa las transacciones de los demás servicios. Se puede decir que es la navaja suiza Lightning.

5.1 Inicializando LNbits

Lo primero que haremos es acceder a la web que ya configuramos en el tutorial de NPM: https://lnbits.cashu4community.xyz. Al ser la primera vez, se nos muestra una página que nos permitirá crear la cuenta del superusuario, que tiene los máximos privilegios. Solo necesitaremos introducir un nombre de usuario y la contraseña (dos veces).

Imagen 1: Creación de cuenta superusuario en LNbits.

LNbits First Install
  1. Introducimos el nombre del usuario.
  2. Introducimos la contraseña de la cuenta dos veces. Se recomienda una contraseña con mínimo 12 caracteres, mayúsculas, minúsculas y caracteres especiales.
  3. Presionamos LOGIN para crear la cuenta.

Imagen 2: Página de Iniciar Sesión.

LNbits Login Page
  1. Introducimos el usuario creado en el paso anterior.
  2. Hacemos lo mismo con la contraseña.
  3. Hacemos clic en LOGIN.

Luego de iniciar sesión se carga la página de ajustes de LNbits, podemos navegar por diferentes secciones, este tutorial abarcará las más importantes.

Imagen 3: Página de ajustes de LNbits.

LNbits Funding Page

5.1.1 Ajustes de Fondeo (Backend lightning de LNbits)

Imagen 4: Página de Ajustes (Fondeo).

LNbits Setting Funding Page
  1. Se muestra el Saldo total en las cuentas de LNbits y el saldo del Nodo.
  2. El backend del LNbits para la infraestructura es Lightning Network Daemon (LND). Esta configuración esta definida en el archivo .env que se encuentra en el directorio app-data/lnbits/

5.1.2 Ajustes de Pagos

Imagen 5: Página de Ajustes (Pagos).

LNbits Payment Page
  1. Seleccionamos las monedas fiduciarias que estarán disponibles en LNbits.
  2. Seleccionamos la moneda por defecto que mostrará el valor de los sats en la cuenta.
  3. Seleccionamos la comisión que se cobrará por las transacciones salientes (solo si se quiere obtener una pequeña ganancia)
  4. Si asignamos un valor a la comisión por transacción, debemos agregar el ID de la billetera que recibirá las comisiones. En los pasos siguientes explicaremos cómo obtener el ID de la billetera.
  5. Deshabilitamos la comisión para las transacciones internas.
Nota: Después de realizar los cambios debemos hacer clic en SAVE y por último en RESTART SERVER si no lo hacemos no se aplicarán los cambios.

5.1.3 Ajustes de Extensiones

Desde esta página podremos seleccionar las extensiones que se cargarán por defecto, tanto en las secciones administrativas como en las de usuarios estándar (sin privilegios).

Imagen 6: Página de Ajustes (Extensiones).

LNbits Settings Extensions
  1. Seleccionamos las extensiones para usuarios administradores.
  2. Seleccionamos las extensiones para el resto de los usuarios.
Nota: Aquí solo aparecerán las extensiones que estén habilitadas. Para añadir otras extensiones hay que ir al apartado de Extensiones en el menú de opciones a la izquierda de la página.

5.2 Creando una billetera para las comisiones por transacción

Cuando iniciamos sesión en LNbits se crea una billetera por defecto, vamos a renombrarla y usarla para recibir las comisiones por transacción.

Imagen 7: Cambiar el nombre a la billetera por defecto.

LNbits Wallet Rename
  1. Seleccionamos el monedero.
  2. Hacemos clic en el panel derecho en Wallet Config.
  3. Cambiamos el nombre de la billetera por Service fees.
  4. Hacemos clic en el botón UPDATE NAME

De esta manera hemos cambiado el nombre de la billetera para saber cual es el fin de esta.

Imagen 8: Obteniendo el ID de la billetera Service fees.

LNbits Wallet ID
  1. Hacemos clic en el panel derecho en Node URL, API Key and API docs.
  2. Copiamos el campo Wallet ID

Luego vamos a los ajustes Pagos (lo que vimos en la sección 5.1.2) y pegamos el ID de la billetera en el campo del punto 12.

5.3 Extensiones de LNbits

Las extensiones de LNbits son plugins que añaden funcionalidades específicas. Permiten desde crear billeteras con reglas personalizadas (límites, expiración) hasta integrar sistemas de pagos, comercio electrónico, boletos, juegos, crowdfunding o mecanismos como LNURL. Al ser modulares, instalalos solo lo que necesitas sin inflar el sistema.

Ahora veremos como añadir y eliminar extensiones.

Imagen 9: Extensiones.

LNbits Extension Page
  1. Hacemos clic en la vista de extensiones para listar las extensiones disponibles.

Por defecto solo un par de extensiones están disponibles para los usuarios, por lo que hay que instalar el resto. En el siguiente paso explicamos cómo se instalan.

Imagen 10: Selección de la extensión a instalar.

LNbits Select Extension to Install
  1. Seleccionamos la extensión a instalar.

En el ejemplo seleccionamos la extensión LndHub, muy útil si queremos usar billeteras como Blue Wallet o Zeus Wallet para administrar los fondos, pagar y recibir pagos en nuestra cuenta.

Imagen 11: Seleccionar versión a instalar.

LNbits Extension Select Version
  1. Desplegamos la lista de versiones.
  2. Seleccionamos la disponible haciendo clic en INSTALL

Luego de unos segundos la extensión aparecerá en la vista de instaladas.

Imagen 12: Extensiones instaladas.

LNbits Installed Extensions

Para comenzar recomiendo instalar las extensiones LNURLp, Withdraw Links y LndHub. Luego de esto podemos ir a los ajustes sección de Extensiones y habilitar para todos los usuarios las extensiones instaladas lo vimos en el paso 5.1.3 en el punto 15.

5.4 Otras opciones

En la vista principal podemos encontrar otras opciones que nos permitirán tener un control más amplio de lo que sucede en nuestra instancia de LNbits.

Imagen 13: Opciones Avanzadas de Administración de la instancia LNbits.

LNbits Advanced Options
  1. Ajustes de LNbits.
  2. Administración de usuarios y billeteras.
  3. Peticiones a la API de Lnbits en tiempo real.
  4. Visualización de los pagos realizados, con información útil para hacer búsquedas.
  5. Administración de extensiones.

5.5 Respaldando la Base de datos y las configuraciones de LNbits

LNbits permite realizar una copia de seguridad de la base de datos, extensiones y logs desde la interfaz web. Si queremos hacer un respaldo manual basta con ir a los ajustes y hacer clic en DOWNLOAD DATABASE BACKUP como se muestra en la siguiente imagen.

Imagen 14: Salva de la base de datos desde ajustes.

LNbits Download Database Backup
  1. Descargamos las base de datos.