X-twitter Instagram Linkedin-in Icon-nostr_logo_wht
Asociate
Todos los tutoriales

LNbits

Plataforma de contabilidad comercial

presentation

Sistema contable

LNbits está repleto de herramientas para controlar y canalizar tus fondos entrantes y salientes, conectar tu tienda web o incluso dispositivos como una cartera de hardware o un cajero automático que hayas construido tú mismo. Los tipos de usuario incluyen:

  • Propietarios de billeteras que deseen utilizar LNbits como interfaz para la gestión de sus fondos, así como sus funciones adicionales.
  • Comerciantes o proveedores de servicios online y offline que quieran aceptar pagos con Bitcoin onchain y Lightning Network.
  • Desarrolladores que quieran crear aplicaciones de la Red Lightning.
  • Operadores de nodos que deseen integrar su nodo con el sistema LNbits a efectos contables.
  • Todos ellos tienen necesidades diferentes. Construimos LNbits de forma modular para que cada usuario pueda utilizar nuestras funciones de la forma que más le convenga.

Gestor de carteras

LNbits es un sistema de contabilidad gratuito y de código abierto, no un gestor de nodos. La gestión de canales la realiza el nodo Lightning que está conectado a LNbits como fuente de financiación ya sea LND o c-lightning. El superusuario o los usuarios administradores del sistema LNbits son los responsables de gestionar la accesibilidad general y la configuración de las funciones de contabilidad y las extensiones internas.

LNbits actúa como interfaz entre el usuario y el nodo Lightning, proporcionando una forma sencilla y fácil de manejar e interactuar con la red de pagos.

Piensa en LNbits como un «framework modular de wordpress» para tu nodo. Una plataforma fácil de gestionar, basada en extensiones que puedes combinar para numerosos casos de uso.

Piensa en LNbits como tu propio software de gestión financiera bancaria. Tu nodo ofrece canales para pagar a través de LNbits y se extiende a tu nodo para ser capaz de ejecutar más allá de la billetera lightning con la que viene tu nodo. Estas billeteras no tienen por qué pertenecerte a ti. Digamos que tú, como gestor del nodo LN, ya tienes suficiente liquidez de canales y fondos y ahora quieres ofrecer algunos servicios bancarios Bitcoin a tus amigos, familia, tienda propia u otros comerciantes habituales.

Les ofrecerás una forma sencilla de abrir una «cuenta bancaria» en tu nodo sin tener acceso a otros monederos de tu nodo y a toda la liquidez de tu nodo, sino sólo a su parte. Tu nodo (el banco) sólo actúa como proveedor de transporte para sus pagos (entrada/salida).

NOTA: todos los fondos que tus «clientes» depositen en sus cuentas bancarias de LNbits en tu nodo, irán directamente a los canales LN de tu nodo. Eso significa que TÚ eres el verdadero propietario de esos fondos. Tendrás una gran responsabilidad sobre sus fondos. No seas malvado y huyas con los fondos, no seas malvado y cobres altas comisiones. Queremos joder a los banqueros fiat, no joder a los demás (usuarios de Bitcoin).

Plataforma de demostración

La demo se puede encontrar en https://legend.lnbits.com. Es totalmente funcional y se puede utilizar para aprender acerca de la Lightning Network y las características de LNbits y LNURL en general. Aunque no podemos impedírtelo, nos gustaría pedirte que no lo utilices para tu configuración de producción. No sólo estamos trabajando en los servidores a menudo para probar nuevas características, sino que también nos gustaría animarte a ejecutar tu propio nodo y LNbits de forma soberana. Si crees que gestionar un nodo es demasiado pedir por el momento puedes conectar LNbits a un servicio de custodia de fondos en la nube como Opennode, Luna o Votage o al Lightning Tipbot en Telegram sólo por nombrar algunos.

Folleto LNbits

¿Quieres entregar información básica a un comerciante o a un amigo desarrollador? Nos complace anunciar nuestro primer folleto para uso de todos. El tamaño es un flyerformato típico global con 6 páginas (2 pliegues) y una anchura de 3508 y una altura de 2480px.

LNbits para comerciantes: EN | DE | ES | IT | PL

LNbits para desarrolladores: EN | DE | ES | IT | PL

Algunos aspectos básicos

LNbits funciona basándose en el protocolo LNURL, lo que significa que las solicitudes son válidas de dos formas: como enlace https:// clearnet (no se permiten certificados autofirmados) o como enlace http:// v2/v3 onion. Para ofrecer servicios LNbits como los códigos QR LNURLp/w o las tarjetas NFC, que se pueden utilizar in the wild, tendrás que abrir LNbits a clearnet (https).

Antes de instalar LNbits asegúrese de haber leído y comprendido las siguientes guías generales sobre qué es LNbits y qué posibilidades le ofrece.

Aquí encontrarás guías más detalladas sobre el uso de LNbits en casos concretos:

Instalar LNbits

Guía básica de instalación

LNbits puede instalarse en cualquier máquina con sistema operativo Linux. No requiere una máquina o servidor potente, sólo suficiente memoria RAM y algo de espacio en disco para la base de datos. Se puede ejecutar por separado de un nodo BTC/LN (PC local o VPS remoto) o juntos en la misma máquina con el nodo o ya instalado en una máquina de software de nodo de paquete.

Puedes elegir entre los gestores de paquetes más comunes como poetry y nix. Por defecto, LNbits utilizará SQLite como base de datos. También puedes usar PostgreSQL, que se recomienda para aplicaciones con mucha carga. Aquí hay una guía para la instalación básica usando poetry o nix.

Para todos aquellos que sean nuevos en esto, encontrarán guías paso a paso más detalladas para conseguir que sus LNbits funcionen en entornos específicos:

También puedes encontrar un video en el dockerised Configuración en un VPS con PostgreSQ, LightningTipBot como fuente de financiación utilizando nginx.

Más escenarios de instalación aquí.

Para los nodos de software de paquetes, consulta la documentación específica sobre LNbits: Citadel | Umbrel | MyNode | RaspiBlitz | RaspiBolt

LNbits SaaS

Cuando no te interesan los aspectos técnicos y no quieres alojar tu fuente de financiación ni tus LNbits tú mismo, existe una versión LNbits SaaS (Software-as-a-service) que puedes utilizar. Es básicamente como LNbits en una nube, pero puedes definir la fuente de financiación (por ejemplo, tu Nodo, una cartera LNbits, el LNtipbot, fakewallet, etc.) y las variables de entorno tú mismo, lo que no suele ser el caso en otras soluciones en la nube.

Aquí encontrará una guía detallada sobre cómo utilizar LNbits SaaS para casos de uso específicos.

Fuentes de financiación

LNbits no es un software de gestión de nodos, sino un sistema de contabilidad centrado en LN sobre una fuente de financiación LND o CLN. Después de la primera instalación puedes visitar tu LNbits en http://localhost:5000/.

Para modificar la fuente de financiación ve a la URL de superusuario y selecciona una fuente de financiación dentro de «Gestionar servidor» o edita el archivo .env modificando LNBITS_BACKEND_WALLET_CLASS a la fuente necesaria si estableces adminUI=TRUE en el .env.

Encontrarás el archivo .env dentro de tu carpeta lnbits/ o lnbits/apps/data extendiendo el comando para listar archivos en tu directorio mediante ls -a.

Es posible que también tengas que instalar paquetes adicionales o realizar pasos de configuración adicionales, seleccionando la fuente de financiación deseada. Tras un reinicio, tu nueva configuración estará activa.

¿Qué fuentes de financiación puedo utilizar para LNbits?

LNbits puede funcionar sobre muchas fuentes de financiación en Lightning Network. Actualmente hay soporte para CoreLightning, LND, LNbits, LNPay, OpenNode, y se añaden más regularmente.

Es importante elegir una fuente que tenga una buena liquidez y buenos pares conectados. Si utilizas LNbits para servicios públicos, los pagos de tus usuarios sólo podrán fluir alegremente en ambas direcciones.

Un monedero backend (fuente de fondos) puede configurarse utilizando las siguientes variables de entorno de LNbits en el archivo .env o dentro de su cuenta de superusuario en la sección Manage-Server.

Si deseas utilizar la versión .env encuentra los parámetros aquí:

CoreLightning

  • CLN
    • LNBITS_BACKEND_WALLET_CLASS: CoreLightningWallet
    • CORELIGHTNING_RPC: /archivo/ruta/lightning-rpc
  • Spark (c-lightning)

Daemon de la Lightning Network

  • LND (RESTO)
    • LNBITS_BACKEND_WALLET_CLASS: LndRestWallet
    • LND_REST_ENDPOINT: http://10.147.17.230:8080/
    • LND_REST_CERT: /archivo/ruta/tls.cert
    • LND_REST_MACAROON: /archivo/ruta/admin.macaroon o Bech64/Hex
    • LND_REST_MACAROON_ENCRYPTED: eNcRyPtEdMaCaRoOn
  • LND (gRPC)
    • LNBITS_BACKEND_WALLET_CLASS: LndWallet
    • LND_GRPC_ENDPOINT: dirección_ip
    • LND_GRPC_PORT: puerto
    • LND_GRPC_CERT: /archivo/ruta/tls.cert
    • LND_GRPC_MACAROON: /archivo/ruta/admin.macaroon o Bech64/Hex

También puedes utilizar en su lugar un macaroon cifrado con AES (más información) utilizando

  • LND_GRPC_MACAROON_ENCRYPTED: eNcRyPtEdMaCaRoOn

Para cifrar tu macaroon, ejecuta ./venv/bin/python lnbits/wallets/macaroon/macaroon.py.

LNbits (otra instancia de LNbits)

  • Instancia de LNbits alojada en un servidor en la nube o en tu propio servidor doméstico
  • Servidor de demostración de LNbits Legend (!! ¡¡¡NO utilices éste para producción / fines comerciales, sólo para pruebas!!)

Lightning TipBot

Para conectar tu Lightning Tipbot desde Telegram necesitarás configurar el siguiente parámetro:

  • LNBITS_BACKEND_WALLET_CLASS: LnTipsWallet
  • LNBITS_ENDPOINT: https://ln.tips
  • LNBITS_KEY: Para obtener la Clave tendrás que ejecutar /api en un chat privado con el LightningTipbot en Telegram una vez.

También ver este tutorial cómo instalar LNbits con LightningTipBot a través de vps

IBEX HUB

Regístrate aquí y obtén tus claves/tokens desde allí, el endpoint es https://ibexpay-api.ibexmercado.com.

Más información en IBEX API-Documentation.

LNPay

Para que el receptor de pagos funcione, debes tener una URL de acceso público en tu LNbits y configurar un LNPay webhook que apunte a <tu host LNbits>/wallet/webhook con el evento «Wallet Receive» y sin indicar ningún secreto. La configuración https://mylnbits/wallet/webhook será la url del endpoint que recibirá la notificación de cualquier pago.

  • LNBITS_BACKEND_WALLET_CLASS: LNPayWallet
  • LNPAY_API_ENDPOINT: https://api.lnpay.co/v1/
  • LNPAY_API_KEY: sak_apiKey
  • LNPAY_WALLET_KEY: waka_apiKey

OpenNode

Para que el cobro funcione, necesitas tener una URL accesible públicamente en tu LNbits. La configuración del webhook es opcional.

  • LNBITS_BACKEND_WALLET_CLASS: OpenNodeWallet
  • OPENNODE_API_ENDPOINT: https://api.opennode.com/
  • OPENNODE_KEY: opennodeAdminApiKey

Alby

Alby es una extensión del navegador con funcionalidades de monedero LN y cuenta LNDHUB que puede utilizarse como fuente de financiación para LNbits. Más información aquí.

Para que el cobro funcione debes tener una URL accesible públicamente en tu LNbits. No es necesario configurar manualmente el webhook. Puedes generar un token de acceso Alby aquí: https://getalby.com/developer/access_tokens/new

  • LNBITS_BACKEND_WALLET_CLASS: AlbyWallet
  • ALBY_API_ENDPOINT: https://api.getalby.com/
  • ALBY_ACCESS_TOKEN: AlbyAccessToken

Guías adicionales / de solución de problemas

Aquí tienes algunas instrucciones adicionales en caso de que las necesites. Haga clic en la flecha para ampliar la descripción.

The Killswitch 🚨

Últimamente se han producido tantos fallos peligrosos no sólo en todo el espacio, sino también en LNbits, que hemos decidido hacer algo al respecto. Ahora puedes optar por recibir advertencias y/o tomar medidas directas, cuando una vulnerabilidad o un error que podría conducir a la pérdida de fondos se produce de nuevo.

killswitchn

Si se cambia a void-wallet todos los tipos de usuario de la instancia verán un banner amarillo donde normalmente se encontraría el aviso «LNbits está en Beta» junto al área de tema/idioma a la derecha – y es la pista más obvia de que algo ha pasado. Echa un vistazo a tu nueva pestaña de servidor resaltada en verde en la parte izquierda de la ventana.

¿Cómo funciona? Cuando el killswitch está activado, un repositorio secreto de github sólo disponible para el equipo central de LNbits será comprobado en un intervalo de X minutos (que puede ser especificado). Si se publica un error vulnerable en este repositorio, sirve como una señal que activa el killswitch en todas las instalaciones que se suscribieron y las transiciones de su instancia lnbits para utilizar el monedero vacío. Si las nubes se han despejado y has instalado la actualización de seguridad puedes establecer tu fuente de financiación a tu nodo, monedero o lo que estés usando de nuevo también a través de la sección Gestionar Servidor. Esta wiki tiene una sección sobre cómo cambiar las fuentes de financiación si no sabes qué configurar.

Diferencia entre admin y superusuario

La interfaz de administración de LNbits le permite cambiar la configuración de LNbits a través del frontend de LNbits. Está desactivado por defecto y la primera vez que se establece la variable de entorno LNBITS_ADMIN_UI=true en el archivo .env, la configuración se inicializa y se utilizará. A partir de ese momento se utilizarán los ajustes de la base de datos en lugar de los del archivo .env.

Superusuario

Con la interfaz de administración hemos introducido el superusuario, que tiene acceso al servidor, por lo que puedes cambiar la configuración que puede bloquear el servidor o hacer que no responda a través de frontend y API, como por ejemplo cambiar la fuente de financiación. El superusuario sólo se almacena dentro de la tabla de configuración de la base de datos. Después de que la configuración se «restablece a los valores predeterminados» y se reinicie, se crea un nuevo superusuario. También hemos añadido un decorador para las rutas API para comprobar la existencia de un superusuario. Tu ID nunca se envía a través de la API y el frontend y sólo recibe un bool (sí/no) si es superusuario o no.

Sólo el superusuario está autorizado a brrrr satoshis a diferentes billeteras a través de la sección «Recargar».

También puedes publicar el superusuario a través de webhook a otro servicio cuando se crea. Más información aquí https://github.com/lnbits/lnbits/blob/main/lnbits/settings.py class SaaSSettings

En el frontend también encontrarás la posibilidad de cambiar la imagen de la tienda que se muestra en la página «crear monedero» abriendo la sección Gestionar Servidor y eligiendo Tema -> Logotipo Personalizado.

Usuarios administradores

Variable de entorno: LNBITS_ADMIN_USERS, lista de identificadores de usuario separados por comas. Los usuarios administradores pueden cambiar la configuración en la interfaz de administración – con la excepción de la configuración de la fuente de financiación, porque esto requeriría un reinicio del servidor y potencialmente podría hacer que el servidor inaccesible. También tienen acceso a todas las extensiones dedicadas a ellos en LNBITS_ADMIN_EXTENSIONS.

Usuarios permitidos

Variable de entorno: LNBITS_ALLOWED_USERS, lista de IDs de usuarios separados por comas. Al definir estos usuarios, LNbits ya no podrá ser utilizado por el público. Sólo los usuarios definidos y los administradores podrán acceder al frontend de LNbits.

Actualizar LNbits

Una actualización normal de tu instancia local de LNbits se realiza simplemente copiando y pegando los siguientes comandos CLI:

cd lnbits
## Stop LNbits with `ctrl + x`
git pull
## Keep your poetry install up to date, this can be done with
poetry self update
poetry install --only main
## or
git checkout main && git pull && poetry install
## Start LNbits with
poetry run lnbits

Si ejecutas Raspiblitz o MyNode puede que necesites adicionalmente un

sudo systemctl restart lnbits

al final, porque ejecuta LNbits como un servicio.

En Umbrel/Citadel los comandos serían

cd ~/apps/lnbits
git pull upstream main
sudo ~/scripts/app start lnbits

Migración de SQLite a PostgreSQL

Si ya tienes LNbits instalado y funcionando en una base de datos SQLite, te recomendamos que migres a Postgres si estás planeando utilizar LNbits a gran escala.

Hay un script incluido que puede hacer la migración fácilmente. Necesitas tener Postgres ya instalado y debería haber una contraseña para el usuario (ver la guía de instalación de Postgres más arriba). Además, tu instancia de LNbits necesita ejecutarse una vez en Postgres para implementar el esquema de la base de datos antes de que la migración pueda funcionar:

# STOP LNbits
# add the database connection string to .env 'nano .env' LNBITS_DATABASE_URL=
# postgres://<user>:<password>@<host>/<database> - alter line bellow with your user, password and db name
LNBITS_DATABASE_URL="postgres://postgres:postgres@localhost/lnbits"
# save and exit
# START LNbits
# STOP LNbits
poetry run python tools/conv.py
# or
make migration

Esperemos que ahora todo funcione y se migre… Inicia LNbits de nuevo y comprueba que todo funciona correctamente.

Copia de seguridad y restauración de la base de datos

Consulta esta guía muy detallada sobre el proceso de copia de seguridad y restauración.

Financiar mi monedero LNbits desde mi nodo no funciona

Si quieres enviar sats desde el mismo nodo que es la fuente de financiación de tus LNbits, tendrás que editar el archivo lnd.conf.

Los parámetros a incluir son: allow-circular-route=1

Házlo en la sección Opciones de aplicación de tu lnd.conf. De lo contrario, el inicio de LND podría fallar en algún nodo del paquete.

NOTA: Se recomienda utilizar la nueva extensión adminUI con la opción «TopUp» para añadir fondos a una cuenta de LNbits.

Error 426

Recibí el error «lnurl necesita ser entregado sobre dominio https de acceso público o tor. 426 upgrade required»

Este error generalmente se debe a que tu LNbits detrás de un túnel ngnix no está reenviando la dirección LNURL correctamente. Detén tu LNbits y edita el archivo .env añadiendo esta línea:

FORWARDED_ALLOW_IPS=*

Además, si utilizas una configuración ngnix, asegúrate de tener estos encabezados en la configuración ngnix:

RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME}
RequestHeader set "X-Forwarded-SSL" expr=%{HTTPS}

Error de red

Obtengo «error https», error de red» u otros al escanear un QR

Malas noticias, se trata de un error de enrutamiento que puede tener bastantes razones. Primero comprueba el LNURL del QR con el Lightning Decoder si puedes encontrar algo raro ahí. Vamos a probar algunos de los problemas más posibles y sus soluciones.

LNbits funciona sólo a través de Tor, no puedes abrirlo en un dominio público como lnbits.tudominio.com

  • Dado que quieres que tu configuración permanezca así abre tu monedero LNbits usando el .onion URI y créalo de nuevo. De esta manera el QR se genera para ser accesible a través de este .onion URI así que sólo a través de Tor. No generes ese QR desde un URI .local, porque no será accesible a través de internet – sólo desde dentro de tu LAN.
  • Abre la aplicación del monedero LN que utilizaste para escanear el QR y esta vez utiliza Tor (consulta la configuración de la aplicación del monedero). Si la aplicación no ofrece Tor, puedes usar Orbot (Android) en su lugar. Consulta la sección de instalación para obtener instrucciones detalladas sobre cómo abrir tus LNbits para clearnet/https.

Evitar que otros generen monederos en mis LNbits

Cuando ejecutas tus LNbits en clearnet básicamente todo el mundo puede generar una cartera en él. Dado que los fondos de tu nodo están ligados a estos monederos es posible que quieras evitarlo. Hay dos maneras de hacerlo:

Configura los usuarios y extensiones permitidos en el archivo .env (ve el ejemplo de env aquí). Esto solo funciona si usas la opción adminUI=FALSE en el archivo .env, de lo contrario necesitas hacerlo en la sección Administrar Servidor -> Usuarios -> Usuarios Permitidos. Todos los demás no serán permitidos después.

Personalizar el plazo de vencimiento de los recibos

Ahora puedes generar cobros con una caducidad personalizada. Compatible con backends: LndRestWallet, LndWallet, CoreLightningWallet, EclairWallet, LnbitsWallet, SparkWallet ¡hasta ahora!

Establece LIGHTNING_INVOICE_EXPIRY en el archivo .env o utiliza la AdminUI para cambiar el valor por defecto para todos los cobros. También hay un nuevo campo en el punto final /api/v1/payments donde puedes establecer la caducidad en los datos JSON.

Cartera-URL suprimida

Cartera en el servidor de demostración legend.lnbits

Guarda siempre una copia de tu wallet-URL, Export2phone-QR o LNDhub de tus propias billeteras en un lugar seguro. LNbits NO PUEDE ayudarte a recuperarlos si los pierdes.

Monedero en tu propia fuente/nodo de financiación

Guarda siempre una copia de tu wallet-URL, Export2phone-QR o LNDhub de tus propias billeteras en un lugar seguro. Puedes encontrar todos los usuarios de LNbits y wallet-IDs en tu extensión LNbits user manager o en tu base de datos SQlite. Para editar o leer la base de datos de LNbits, ve a la carpeta LNbits /data y busca el archivo llamado sqlite.db. Puedes abrirlo y editarlo con excel o con un editor SQL dedicado como SQLite browser.

También puede volcar las carteras a través de CLI y ver cada cartera dentro de su base de datos.

cd ~/app-data/lnbits/data
sqlite3 database.sqlite3
.dump wallets

El resultado será algo parecido a esto

INSERT INTO wallets VALUES('f8a43fc363ea428db5c53b3559935f1f','NAME OF WALLET','1280ff5910a9c485a782a2376f338b6c','33b95b099ce848e3b484124373f681e5','2cca208ae6d94d438227b9487ff216f9');

y puedes poner estos valores en una url como esta

https://your.lnbits.com/wallet?usr=1280ff5910a9c485a782a2376f338b6c&wal=f8a43fc363ea428db5c53b3559935f1f

Sustituye f8a43fc363ea428db5c53b3559935f1f por el valor que aparece antes del nombre (en nuestro ejemplo f8a43fc363ea428db5c53b3559935f1f) y 1280ff5910a9c485a782a2376f338b6c es tu usuario y debería convertirse en el valor que aparece después del nombre. Para salir de sqlite3 pon

.quit

LNURL para una dirección lightning viceversa

Prueba este codificador de fiatjaf o este. Para pagar o comprobar un LNURLp también puedes utilizar LNurlpay. Debes indicar HTTPS NO HTTP.

Configurar un comentario que la gente ve cuando paga a mi LNURLp QR

Cuando se crea una LNURL-p, por defecto no se rellena la casilla de comentarios. Eso significa que no se permite adjuntar comentarios a los pagos.

Para permitir comentarios, añade la longitud de caracteres de la casilla, de 1 a 250. Una vez que pongas un número, la caja de comentarios se mostrará en el proceso de pago. También puedes editar un LNURL-p ya creado y añadir ese número.

lnbits comments

Depositar onchain BTC a LNbits

Hay dos maneras de intercambiar sats de onchain BTC a LN BTC (resp. a LNbits).

A través de un servicio de intercambio externo.

Otros usuarios que no tengan acceso a tu LNb its pueden utilizar un servicio de intercambio como Boltz, FixedFloat, DiamondHands o ZigZag. Esto es útil si sólo proporcionas facturas LNURL/LN desde tu instancia de LNbits, pero un pagador sólo tiene Sats onchain, por lo que tendrá que intercambiar primero esos Sats. El procedimiento es sencillo: el usuario envía btc onchain al servicio de intercambio y proporciona la factura LNURL / LN de LNbits como destino del intercambio.

Uso de la extensión LNbits de Onchain y Boltz.

Ten en cuenta que se trata de un monedero independiente, no del monedero de LN BTC que LNbits representa como «tu monedero» en tu fuente de financiación de LN. Este monedero onchain también se puede utilizar para intercambiar BTC LN a (por ejemplo, tu hardwarewallet) mediante el uso de la extensión LNbits Boltz o Deezy. Si tienes una tienda online que está vinculada a tu LNbits para pagos LN, es muy útil transferir regularmente todos los Sats de LN en onchain. Así tendrás más espacio en tus canales LN para poder recibir nuevos sats frescos.

Procedimiento para quienes no disponen de un monedero físico de Bitcoin:

  • Utiliza Electrum o Sparrow wallet para crear una nueva billetera Onchain y guarda la frase semilla en un lugar seguro.
  • Ve a la información de la billetera y copia el xpub.
  • Ve a LNbits – Extensión Onchain y crea un nuevo monedero sólo para relojes con ese xpub.
  • Ve a LNbits – Extensión Tipjar y crea un nuevo Tipjar. Selecciona también la opción Onchain además del monedero LN.
  • Opcional – Ve a la extensión LNbits – SatsPay y crea un nuevo cargo para Onchain BTC. Puedes elegir entre onchain y LN o ambos. A continuación, creará una cobro que se puede compartir.
  • Opcional – Si utilizas tus LNbits vinculados a una página de WordPress + Woocommerce, una vez que crees/vincules una billetera de solo lectura a tu monedero de la tienda LN btc, el cliente tendrá ambas opciones para pagar en la misma pantalla.

Cuando reciba un pago en LNbits, el registro de transacciones sólo mostrará un tipo reanudado de la transacción.

lnbits payment details

En el resumen de transacciones encontrarás una pequeña flecha verde para los fondos recibidos y una flecha roja para los fondos enviados.

Si haces clic en esas flechas, una ventana emergente de detalles muestra los mensajes adjuntos, así como el nombre del remitente, si se indica.

Configurar un nombre para que aparezca en los pagos, en LNbits actualmente no es posible hacerlo – pero sí recibirlo. Esto sólo es posible si el monedero LN del remitente soporta LUD-18 (nameDesc) como OBW, Blixt, Alby, ZBD, BitBanana.

A continuación, verás un alias/pseudónimo en la sección de detalles de sus transacciones de LNbits (haz clic en las flechas). Ten en cuenta que puedes poner cualquier nombre allí y puede que no esté relacionado con el nombre del remitente real si recibe tal.

lnbits namedesc

Para importar tu cuenta LNbits en una aplicación de monedero, abre tu LNbits con la cuenta / monedero que quieras utilizar, ve a «gestionar extensiones» y activa la extensión LNDHUB. Abre la extensión LNDHUB, elige el monedero que quieres usar y escanea el QR de «admin» o «sólo factura», dependiendo del nivel de seguridad que quieras para ese monedero.

Puedes utilizar Zeus o Bluewallet como aplicaciones de monedero para una cuenta de LNDHUB, ya que BW admite más de un monedero.

Al hacer esto, recomendamos también establecer el URI de la red LN al de tu propio nodo. Si tu instancia de LNbits es sólo Tor, también tienes que usar esas aplicaciones con Tor activado. También en este caso necesitas abrir la página de LNbits a través de tu dirección Tor .onion.

Si recibes un Error «unsupported hash type» cuando usas ypub en la extensión On-chain, comprueba si tu instancia de LNbits está usando python 3.10 podría estar afectada por este problema. Edita el openssl.cnf como se describe en la respuesta de stackoverflow y reinicia tu LNbits.

Herramientas y construcción con LNbits

LNbits tiene todo tipo de APIs abiertas y herramientas para programar y conectarse a un montón de dispositivos diferentes para un gazillion de casos de uso.

Si eres nuevo en el mundo del desarrollo, empieza con estas presentaciones MakerBits de Ben Arc sobre el desarrollo de gadgets basados en LNbits.

IMPORTANTE:

  • LNbits funciona basado en el protocolo LNURL cuyas peticiones son válidas de dos formas: como enlace https:// clearnet (no se permiten certificados autofirmados) o como enlace http:// v2/v3 onion. Para ofrecer servicios LNbits como los códigos QR LNURLp/w o las tarjetas NFC, que se pueden utilizar in the wild, tendrás que abrir LNbits a clearnet (https).
  • Utiliza sólo cables de DATOS para alimentar tu esp32. No todos los cables soportan datos además de alimentar el esp. No serías el primero si el cable que viene con el esp es de sólo alimentación
  • Asegúrate de no usar un USB-Hub con otros dispositivos conectados. Esto puede provocar efectos extraños difíciles de depurar (por ejemplo, que no se inicie o se detenga).
  • Para realizar proyectos esp con un MacOS necesitarás un UART Bridge Driver. Si tienes problemas con el driver en sistemas Mac o Linux, puedes encontrarlos aquí o, si se trata de un TTGO Display este. Si está en Windows y tienes problemas para conectarse asegúrate de descargar la versión ANTIGUA 11.1.0 porque la nueva no funciona. También puedes encontrar un terminal serie aquí para comprobar tu conexión – configurado a 115200 baudios.
  • Aunque es mucho más cómodo utilizar Platform.io (por ejemplo, las dependencias se instalan automáticamente) recomendamos el uso de Arduino para todos los nuevos en el desarrollo.
  • Pantalla TT-Go S3: El color de la lengüeta de la lámina protectora de pantalla te indica qué controlador exactamente (ST7735_redtab, ST7735_blacktag, ST7735_greetab, greentab128, ..) se ha utilizado para construirla. Guárdalo para poder depurar si se programa y la pantalla no muestra los gráficos correctamente, por ejemplo, colores incorrectos, imágenes reflejadas o píxeles desviados en los bordes. Si alguna vez necesitas hacer esto, hay una guía épica sobre el ajuste para diferentes pantallas
  • Utiliza siempre lnurl239xx en minúsculas en lugar de LNURLl239xx
  • Añadir lightning:lnurl1234xyz creará un QR que solicita abrir la billetera del usuario para este cobro al escanearlo (última aplicación de lightning instalada en iOS, configuración en Android)
  • Si estás flasheando un esp32 vía web sólo funcionará con estos navegadores (TL:DR Chrome, Edge & Opera).
  • Ten en cuenta esta referencia PIN-OUT para el esp
  • Cuando utilices FOSSoftware o FOSGuides, enlaza siempre al autor. A todo el mundo le gusta ver crecer a su bebé y también se inicia una cadena de desarrollo que es bastante impresionante de ver:)

Ven al Grupo de Telegram de Makerbits si necesitas ayuda con un proyecto: ¡Cuenta con nosotros!

lnbits hackathlon

Aquí tienes algunas categorías de proyectos que puedes construir con LNbits:

Acercate

Asociate a BitcoinAr y
obtené beneficios exclusivos

Contacto

Asociación Civil DECODES (ONG Bitcoin Argentina) 

AreaTres, El Salvador 5218, CABA


Tel: +54 9 11 2399-8701

Somos referentes en el ecosistema con
más de 10 años de trayectoria

X-twitter Instagram Youtube Linkedin Tiktok Icon-nostr_logo_wht
Copyright © 2025 ONG Bitcoin Argentina 
Legales
ONG Bitcoin Argentina
Powered by  GDPR Cookie Compliance
Resumen de privacidad

Esta web utiliza cookies para que podamos ofrecerte la mejor experiencia de usuario posible. La información de las cookies se almacena en tu navegador y realiza funciones tales como reconocerte cuando vuelves a nuestra web o ayudar a nuestro equipo a comprender qué secciones de la web encuentras más interesantes y útiles.