LNbits en Cuba Bitcoin

1. Introducción
   1.1. ¿Qué es LNbits?
   1.2. Breve resumen sobre la iniciativa de la comunidad Cuba Bitcoin
2. ¿Cómo crear una cuenta en LNbits?
   2.1 Interfaz LNbits
3. Exportar acceso a la cuenta desde BlueWallet y Zeus
   3.1 ¿Por qué usar una app móvil para gestionar tu cuenta?
   3.2 Accediendo a LNHUB
   3.3 Integración con BlueWallet
   3.4 Integración con Zeus
4. Crear tu propia LN Address desde el servidor
   4.1 ¿Qué es una LN Address?
   4.2 Configuración en LNbits
5. Accediendo al servidor desde Cuba
   5.1 ¿Existen restricciones de acceso?
   5.2 ¿Es necesario usar VPN o Tor?
6. ¿Cómo puedes ayudar a la comunidad?
   6.1 Donaciones para sostener el servidor
   6.2 Reporte de errores y mejoras en la plataforma
   6.3 Participación en la educación y difusión sobre Bitcoin en Cuba
7. Conclusión
   7.1 Próximos pasos y cómo LNbits puede seguir evolucionando en la comunidad
   7.2 Importancia de la autocustodia

1 Introducción

1.1 ¿Qué es LNbits?

LNbits es un sistema de gestión de billeteras y herramientas para Lightning Network, diseñado para ofrecer una interfaz fácil de usar y altamente modular. Permite a cualquier persona crear y administrar múltiples billeteras de Bitcoin sobre Lightning, sin necesidad de configurar un nodo completo. Gracias a su flexibilidad y extensibilidad, LNbits facilita la adopción de Bitcoin al permitir la integración con diferentes aplicaciones y servicios financieros descentralizados.

Su importancia radica en que democratiza el acceso a Lightning Network, brindando una forma sencilla de manejar pagos instantáneos sin fricciones, con soporte para múltiples usuarios y diversas extensiones. Además, al ser software de código abierto, permite a cualquier comunidad desplegar su propia instancia y personalizarla según sus necesidades.

1.2 Breve resumen sobre la iniciativa de la comunidad Cuba Bitcoin

La comunidad Cuba Bitcoin ha tenido que enfrentarse a constantes barreras en su camino hacia la adopción de Bitcoin. Múltiples herramientas y servicios se ven restringidos debido a las sanciones impuestas al pueblo cubano (Más información aquí), lo que dificulta el acceso a la tecnología. Además, muchas plataformas requieren procesos KYC, y debido a las sanciones de la OFAC y las fuertes restricciones económicas, los cubanos son constantemente excluidos del sistema financiero internacional.

En el ámbito de Bitcoin, varias billeteras han bloqueado directa o indirectamente a los usuarios cubanos. Algunas, como Blink Wallet, los prohíben explícitamente. Otras, como Green Wallet y Aqua Wallet, no los bloquean directamente, pero requieren el uso de VPN dentro de Cuba para poder acceder a sus servicios.

En un esfuerzo por fomentar el uso de Bitcoin y la soberanía financiera en la isla, la comunidad Cuba Bitcoin ha lanzado su propio servidor LNbits, operando sobre su propio nodo de Lightning Network:

• LNbits Cuba Bitcoin
• Nodo de Cuba Bitcoin desde Mempool Space
• Nodo de Cuba Bitcoin desde Amboss Space

Esta iniciativa busca proporcionar a los cubanos una herramienta accesible para administrar sus fondos en Lightning sin depender de servicios extranjeros. Cuba Bitcoin siempre ha apostado por soluciones de auto custodia siguiendo el principio maximalista:

“No tus llaves, no tus monedas”

Sin embargo, estas soluciones pueden crear una fricción inicial para nuevos usuarios, debido principalmente a la poca capacidad de fondos para poder abrir canales y pagar comisiones de red, que en ocasiones pueden ser altas para el salario promedio en Cuba (menos de 15 USD al mes), permitiendo menores comisiones para transferencias hacia nodos externos en comparación con los servicios más populares y comisiones de costo 0 para pagos de facturas dentro del mismo nodo.

Con este servicio, la comunidad busca reducir estas barreras, permitiendo a más personas experimentar con Lightning Network y acceder a pagos instantáneos.

2 ¿Cómo crear una cuenta en LNbits?

1. Dirígete a: https://lnbits.cubabitcoin.org/

2. Haz clic en la opción REGISTER para crear una nueva cuenta.

3. Completa los campos necesarios. Para este ejemplo, usaremos el nombre Alice.

4. Haz clic en CREATE ACCOUNT para finalizar el registro.

5. ¡Listo! Ya tienes tu cuenta creada en el LNbits de Cuba Bitcoin.

2.1 Interfaz en LNbits

Vamos a desglosar las partes visibles de la interfaz de LNbits:

1. Menú izquierdo superior

Aquí se encuentran las opciones principales de gestión de la billetera:

Wallets:

• "LNbits wallet" → Es la billetera activa (se pueden tener varias).
• "Add a new wallet" → Permite crear nuevas billeteras dentro del mismo usuario.

2. Menú izquierdo inferior

Aquí se encuentran las opciones principales de gestión de la billetera:

Manage:

• "Extensions" → Sección donde se pueden habilitar extensiones adicionales para mejorar las funcionalidades de LNbits.

Extensions (Extensiones habilitadas en este servidor):

• Bolt Cards: Para administrar tarjetas NFC Lightning.
• Boltz: Permite intercambios atómicos entre Bitcoin on-chain y Lightning.
• LndHub: Permite que la billetera funcione como un servidor de custodia.
• Pay Links: Crea enlaces de pago para recibir donaciones o pagos con Lightning.

3. Panel principal (centro)

Aquí se muestra el estado de la billetera activa:

Saldo:
Se muestra como "0 sats", indicando que no hay fondos en la billetera.

Botones de acción:

• "PASTE REQUEST" → Para pegar una solicitud de pago o factura Lightning.
• "CREATE INVOICE" → Generar una factura para recibir pagos.
• "SCAN" → Escanear un código QR con una solicitud de pago.

Historial de transacciones:
Actualmente muestra "No transactions made yet", lo que indica que aún no se han realizado transacciones.

Exportación de datos:

• "EXPORT TO CSV" → Opción para descargar el historial de transacciones en formato CSV.

4. Panel derecho (opciones avanzadas de la billetera)

Opciones para gestionar la billetera en uso:

• "Export to Phone with QR Code" → Permite exportar la billetera a una aplicación móvil mediante un código QR.
• "Rename wallet" → Posibilidad de cambiar el nombre de la billetera.
• "Fiat tracking" → Activar o desactivar el seguimiento del saldo en moneda fiduciaria.
• "Delete wallet" → Opción para eliminar la billetera (con precaución).
• "Node URL, API keys and API docs" → Muestra la URL del nodo, claves API y documentación para desarrolladores.

3. Exportar acceso a la cuenta desde Blue Wallet y Zeus Wallet

3.1 ¿Por qué usar una app móvil para gestionar tu cuenta?

Usar una app móvil para gestionar tu cuenta en LNbits tiene muchas ventajas. Te permite acceder a tu billetera en cualquier momento y desde cualquier lugar, sin depender de una computadora. Además, la interfaz móvil es más sencilla y rápida para hacer transacciones diarias.

En Lightning Network, la mayoría de los pagos se hacen escaneando códigos QR, lo que significa que con una app móvil puedes generar y pagar facturas en segundos. También puedes habilitar tu LN Address, facilitando recibir pagos sin necesidad de crear facturas manualmente.

En cuanto a seguridad, exportar tu cuenta a una app móvil ayuda a reducir el riesgo de ataques de phishing o malware en navegadores, dándote más control y tranquilidad sobre tus fondos.

3.2 Accediendo a LNDHub

En el menú izquierdo inferior accedemos a la extensión LndHub:

Esta nos muestra dos opciones:

• LNDHUB INVOICE: Nos permite recibir nuestros bitcoins o satoshis en una billetera, pero no nos permite transferirlos (ideal para dueños de negocios).
• LNDHUB ADMIN: Nos permite recibir y enviar nuestros sats.

Si poseemos más de una wallet, la seleccionamos en la opción Select Wallet.

3.3 Integración con BlueWallet

Accedemos a BlueWallet:

• Apple Store
• Google Play

1. En la opción Añadir cartera, seleccionamos Añadir.

2. Seleccionamos la opción Importar cartera.

3. Escaneamos el LNDHUB INVOICE o el LNDHUB ADMIN, de acuerdo al uso que le vayamos a dar… ¡y listo!

3.4 Integración con Zeus Wallet

Accedemos a Zeus Wallet:

• Apple Store
• Google Play
• Descarga directa

1. Seleccionamos CONFIGURACIÓN AVANZADA.

2. Luego, seleccionamos Crear o conectar un monedero.

3. En la parte superior derecha, tocamos el ícono de escanear (un pequeño cuadro) y escaneamos el LNDHUB INVOICE o el LNDHUB ADMIN, de acuerdo al uso que le vayamos a dar.

4. Una vez escaneado, seleccionamos GUARDAR CONFIGURACIÓN DEL MONEDERO.

¡Listo! Ya tenemos nuestra cuenta de LNbits cargada en Zeus Wallet.

4. Crear tu propia LN Address desde el servidor

4.1 ¿Qué es una LN Address?

Una LN Address (dirección Lightning Network) es una dirección única que permite recibir pagos a través de la Lightning Network (LN). Es como un número de cuenta en una red de pagos rápida y económica, que funciona encima de la red principal de Bitcoin.

A diferencia de las direcciones tradicionales de Bitcoin, que son largas y difíciles de recordar, una LN Address es mucho más fácil de usar y se parece a una dirección de correo electrónico (por ejemplo, usuario@dominio.com).

4.2 Configuración en LNbits

1. En la ventana de Extensions, seleccionamos Pay Links.

2. Seleccionamos New Pay Link.

3. Llenamos los campos básicos:
   • En Wallet, seleccionamos la billetera a utilizar.
   • En Item description, ponemos la descripción de la LN Address (ejemplo: Personal account).
   • En Lightning Address, elegimos el nick que usaremos.
   • Min: La cantidad mínima de satoshis a aceptar.
   • Max: La cantidad máxima de satoshis a aceptar.

4. Configuración avanzada:
   • En LNURL, ponemos un número (recomendamos 300, que es la cantidad máxima de caracteres que aceptaremos cuando las personas deseen enviarnos un mensaje enviando sats).
   • También podemos habilitar Zaps en Nostr marcando la opción Enable nostr zaps.

5. Luego, terminamos de crear nuestro link en la opción CREATE PAY LINK, obteniendo una dirección como, por ejemplo, alice@lnbits.cubabitcoin.org.

Podemos modificar en cualquier momento la configuración de nuestra LN Address o eliminarla.

5. Accediendo al servicio desde Cuba

5.1 ¿Existen restricciones de acceso?

En Cuba, el acceso a servicios internacionales puede verse afectado por limitaciones en la infraestructura de internet. Sin embargo, este servicio se crea como una alternativa más para poder cobrar, gastar y utilizar Bitcoin de forma sencilla, rápida y con bajas comisiones dentro del entorno cubano.

5.2 ¿Es necesario usar VPN o Tor?

No es estrictamente necesario usar VPN o Tor para acceder al servidor de LNbits de Cuba Bitcoin, ni para acceder a Blue Wallet o Zeus. Sin embargo, el uso de VPN o Tor es una buena práctica en términos de privacidad y seguridad. En algunos casos, debido a la velocidad de internet en Cuba, puede ser necesario omitir su uso para una experiencia de usuario más fluida.

6. ¿Cómo puedes ayudar a la comunidad?

Puedes contribuir a la comunidad de Cuba Bitcoin de diversas maneras para fortalecer el uso de Bitcoin y Lightning Network en el país. A continuación, te mostramos algunas formas en las que puedes apoyar:

6.1 Donaciones para sostener el servicio:

El mantenimiento y funcionamiento de un servidor dedicado a LNbits y el Nodo de Lightning de Cuba Bitcoin requiere recursos y tiempo constantes. Las donaciones son esenciales para asegurar que este servicio siga disponible para todos los usuarios. Con tu contribución, por pequeña que sea, podremos cubrir gastos como el mantenimiento del servidor, las actualizaciones de seguridad, los costos operativos, la apertura de nuevos canales que mejoren la experiencia del usuario, la reducción de comisiones en las transferencias y la capacidad de aceptar pagos.

Las donaciones se pueden realizar a través de Bitcoin Lightning. Puedes donar a:

• cubabitcoin@lnbits.cubabitcoin.org
• cubabitcoin@walletofsatoshi.com

¡Muchas gracias!

6.2 Reporte de errores y sugerencias de mejora en la plataforma:

Tu participación en la mejora continua de la plataforma es muy importante para nosotros. Si encuentras errores o tienes ideas para optimizar el funcionamiento de LNbits o el Nodo de Lightning de Cuba Bitcoin, no dudes en reportarlos. Tu retroalimentación nos permite corregir fallos, mejorar la experiencia del usuario y mantener la plataforma eficiente y segura.

Si cuentas con un nodo enrutador, puedes abrir canales con el nodo de Cuba Bitcoin.

Puedes enviar tus reportes de errores y sugerencias comunicándote con los administradores en el grupo de Telegram de Cuba Bitcoin. Toda colaboración es bienvenida y contribuye a fortalecer el proyecto.

6.3 Participación en la educación y difusión sobre Bitcoin en Cuba:

La educación es el pilar fundamental de nuestra comunidad. Difundir el conocimiento sobre Bitcoin es clave para fomentar su adopción tanto en Cuba como en el resto del mundo.

Puedes contribuir compartiendo tus conocimientos sobre esta tecnología, organizando talleres, charlas o simplemente difundiendo información clara y precisa sobre su funcionamiento. Al hacerlo, ayudarás a empoderar a más personas para que aprovechen los beneficios de Bitcoin en su vida diaria. Si deseas organizar un taller, meetup o clase en tu comunidad, puedes contar con el apoyo y la experiencia de la comunidad Cuba Bitcoin.

Además, puedes colaborar creando contenido educativo, compartiendo recursos o participando en actividades comunitarias. Síguenos en nuestras redes sociales y apóyanos con un "like" o un "retweet". Tu apoyo ayuda a que nuestro trabajo educativo llegue a más personas.

Redes Sociales:

• X: Cuba_BTC
• Nostr:
  • NPUB: npub1huyn6ru55pv6l7p0sxvlu3vfpq7pan958sl4weft0kte6lvdvvksd5s34t
  • NIP05: cubabitcoin@btcpay.cubabitcoin.org

7. Conclusión

7.1 Próximos pasos y cómo LNbits puede seguir evolucionando en la comunidad

LNbits, como proyecto Open Source, ofrece una flexibilidad excepcional que nos permite adaptarlo a las necesidades específicas de cada contexto. Existen numerosas extensiones por explorar, muchas de las cuales podrían ser sumamente útiles para nuestra comunidad.

Un aspecto importante por revisar es el uso de puntos de venta (POS) y tarjetas NFC. Recordamos con especial interés la charla de Lukas, un bitcoiner alemán, quien en 2023, durante un meetup, nos mostró cómo estas tecnologías pueden integrarse con LNbits para facilitar aún más los pagos en Bitcoin, una opción que merece ser considerada en el futuro cercano.

Además, es crucial explorar cómo LNbits puede integrarse con plataformas de comercio electrónico construidas sobre WordPress, habilitando pagos en Bitcoin de manera sencilla y eficiente. La posibilidad de conectar tiendas en línea con LNbits abriría un nuevo abanico de oportunidades para el comercio basado en Bitcoin.

Las posibilidades son infinitas, y cada día surgen nuevas formas de mejorar la plataforma y expandir su uso.
Te invitamos a unirte a nosotros en el proceso de descubrir y potenciar todas las capacidades que LNbits tiene para ofrecer.

7.2 Importancia de la autocustodia

Aunque este servicio facilita la integración de nuevos usuarios y es una excelente manera de comenzar a interactuar con Bitcoin, es fundamental no considerarlo como la solución definitiva. Bitcoin, tal como lo definió Satoshi Nakamoto en su White Paper, es un sistema peer-to-peer, sin intermediarios.

Al depender de servicios custodiales, corremos el riesgo de confiar en terceros, lo cual entraña ciertos peligros, como la pérdida de fondos o la vulnerabilidad ante ataques externos.

La verdadera solución, siempre que sea posible, está en alcanzar la soberanía financiera mediante la autocustodia de nuestros fondos.
Utiliza el LNbits de Cuba Bitcoin sabiamente.

Cuando hayas acumulado suficientes fondos para abrir un canal de Lightning, te recomendamos abrirlo hacia el nodo de Cuba Bitcoin o hacia cualquier otro nodo de tu elección. Además, si tienes los recursos, el conocimiento y la infraestructura necesaria, considera crear tu propio nodo. De ser necesario, la comunidad estará dispuesta a ayudarte en este proceso.

El objetivo debe ser siempre: ser dueño de tu propio dinero.
Este servicio solo es un trampolín para alcanzar esa meta.

Autor: Forte11

• Sígueme en X : https://x.com/Forte11Cuba
• Sígueme en Nostr:
  • npub: npub1f0rtesc8yd8utjhpgktlltv4t2rftxd5kmkagt5kymt8946pqf7qe90snx
  • NIP05: forte11@cubabitcoin.org

☕ Regálame un cafecito con Lightning Network:
forte11@lnbits.cubabitcoin.org

BTCPay Server en Cuba Bitcoin

1. Introducción
   1.1 ¿Qué es BTCPay Server?
   1.2 Historia y contexto
   1.3 Resumen sobre la iniciativa de la comunidad Cuba Bitcoin
2. Creación de cuenta en BTCPay Server
   2.1 Registro
   2.2 Configuración inicial de la tienda
3. Integraciones con wallets
   3.1 Usar BTCPay Server con LNbits de Cuba Bitcoin
4. Creación de una tienda con BTCPay Server
   4.1 Configuración inicial y opciones de personalización
   4.2 Opciones adicionales de pago
   4.3 Formulario personalizado
   4.4 Roles
   4.5 Crowfund
5. Accediendo al servidor desde Cuba
   5.1 ¿Existen restricciones de acceso?
   5.2 ¿Es necesario usar VPN o Tor?
6. ¿Cómo puedes ayudar a la comunidad?
   6.1 Donaciones para sostener el servidor
   6.2 Reporte de errores y mejoras en la plataforma
   6.3 Participación en la educación y difusión sobre Bitcoin en Cuba
7. Conclusión
   7.1 Próximos pasos y cómo BTCPay Server puede seguir evolucionando en la comunidad

1. Introducción

En este capítulo, explicaremos qué es BTCPay Server, cómo surgió y el contexto detrás de esta herramienta.

1.1 ¿Qué es BTCPay Server?

BTCPay Server es un procesador de pagos de código abierto y autoalojado que permite a comerciantes, desarrolladores y organizaciones aceptar pagos en Bitcoin sin depender de terceros y sin incurrir en tarifas adicionales.

1.2 Historia y contexto

Fue creado en 2017 por Nicolas Dorier, un desarrollador de Bitcoin, en respuesta a una decisión polémica de BitPay, el principal procesador de pagos en Bitcoin en ese momento.

En 2017, BitPay anunció que dejaría de soportar pagos que no usaran BIP-70, un protocolo de pago que generaba preocupaciones en la comunidad por problemas de privacidad y descentralización. Muchos usuarios de Bitcoin, incluidos desarrolladores y comerciantes, rechazaban la implementación de BIP-70 debido a que requería compartir información personal y complicaba la experiencia de pago.

Como respuesta, Nicolas Dorier escribió en Twitter (actual X):

"Eso es mentira, mi confianza en ti está rota. Te haré obsoleto"

Con esa motivación, comenzó a desarrollar BTCPay Server como una alternativa completamente descentralizada y de código abierto. En poco tiempo, el proyecto ganó el apoyo de la comunidad de Bitcoin y se convirtió en la solución preferida para procesar pagos.

Post original: https://x.com/NicolasDorier/status/898378514256207872

1.3 Resumen sobre la iniciativa de la comunidad Cuba Bitcoin

Cuba enfrenta un panorama económico complejo, caracterizado por una fuerte devaluación monetaria, la ausencia de soluciones de pago eficientes y un comercio electrónico en crecimiento pero con múltiples dificultades. La infraestructura bancaria nacional está marcada por la burocracia y la obsolescencia tecnológica, lo que dificulta aún más la integración de pagos digitales.

Además, debido al bloqueo financiero y las restricciones impuestas por la OFAC, muchas plataformas internacionales han restringido o cerrado el acceso a cubanos, dejando a emprendedores y comerciantes con muy pocas opciones para recibir pagos desde el exterior.

Ante este contexto, BTCPay Server es la alternativa ideal, ya que permite recibir pagos en Bitcoin de manera directa, sin intermediarios, y sin riesgo de censura. Sin embargo, la implementación de un servidor propio suele ser un reto para pequeños y medianos comerciantes, e incluso para empresas más grandes.

Para aceptar pagos en Lightning Network usando BTCPay, es necesario operar un nodo Lightning, lo que implica gestionar liquidez, abrir canales y asumir costos por comisiones, una barrera difícil de superar en un país donde el salario promedio es menor a $10 USD al mes. Además, mantener un BTCPay Server requiere un nodo de Bitcoin Core, infraestructura técnica y el pago de servidores, lo que está fuera del alcance de la mayoría de los comerciantes cubanos.

Para solucionar este problema, Cuba Bitcoin ha desplegado un servicio de BTCPay Server, eliminando estas barreras y permitiendo que cualquier persona pueda montar su propia tienda en línea y empezar a aceptar pagos en Bitcoin, sin necesidad de contar con recursos o conocimientos técnicos o financieros avanzados.

Esta iniciativa busca impulsar el comercio electrónico y la adopción de Bitcoin en la isla, brindando una herramienta accesible y sin censura para comerciantes, emprendedores y ciudadanos que buscan una alternativa financiera soberana.

2. Creación de cuenta en BTCPay Server

Este capítulo te guiará paso a paso en el proceso de crear tu cuenta en BTCPay Server, desde el registro inicial hasta la configuración básica de tu tienda.

2.1 Registro

Para comenzar a recibir pagos en Bitcoin con BTCPay Server, primero necesitas crear una cuenta en la instancia de Cuba Bitcoin. Este proceso es rápido y sencillo:

1. Dirígete al sitio web del servidor BTCPay Server de Cuba Bitcoin:
   https://btcpay.cubabitcoin.org
2. En la página principal, haz clic en Registrarse o Sign Up.

3. Completa los campos solicitados:
   • Correo electrónico (se usará para gestionar tu cuenta).
   • Contraseña segura (elige una fuerte y guárdala en un lugar seguro).
4. Haz clic en Create your account.
5. Revisa tu bandeja de entrada y busca el correo de confirmación de BTCPay Server. Si no lo ves, revisa la carpeta de spam.
6. Haz clic en el enlace de confirmación para activar tu cuenta.

¡Listo! Ya tienes tu cuenta en BTCPay Server. Ahora puedes iniciar sesión y empezar a configurar tu tienda.

2.2 Configuración inicial de la tienda

Una vez que has creado tu cuenta en BTCPay Server, el siguiente paso es configurar tu tienda:

1. Inicia sesión en el servidor de BTCPay Server de Cuba Bitcoin.
2. En el panel principal, haz clic en Create Store.
3. Elige un nombre para tu tienda. Puede ser el nombre de tu negocio o cualquier identificador que prefieras.
4. Selecciona la moneda fiat de referencia.
   BTCPay Server permite trabajar con distintas monedas. En el caso de Cuba, se encuentra la opción de CUP (peso cubano) para calcular precios en moneda local.
5. Configura el origen del precio.
   La opción más recomendada para Cuba es Yadio, ya que ofrece una tasa de cambio actualizada y confiable para el contexto cubano.
6. Haz clic en Create Store para guardar la configuración inicial.

Tu tienda ha sido creada.

Opciones de precios

Si prefieres gestionar los precios de tus productos en USD, puedes seleccionar esta configuración.

Si deseas establecer los precios en CUP, te recomendamos esta opción para mayor precisión en el contexto cubano.

Ahora que tu tienda está configurada, en los siguientes capítulos aprenderás a integrar métodos de pago y recibirlos en Bitcoin y Lightning Network.

3. Integraciones con wallets

En este capítulo, aprenderás cómo integrar BTCPay Server con diferentes wallets para facilitar el proceso de pagos y recibir Bitcoin de manera eficiente.

Aunque BTCPay Server permite vincular tu tienda con muchas opciones, las soluciones propuestas aquí están pensadas para el contexto de Cuba, donde acceder a herramientas financieras puede ser un desafío. Sin embargo, estos métodos también pueden ser útiles en otros países.

3.1 Usar BTCPay Server con LNbits de Cuba Bitcoin

Para empezar a aceptar pagos en tu tienda, es necesario configurar una wallet o conectarte a un nodo de Lightning.

La comunidad Cuba Bitcoin ofrece una instancia de LNbits
donde puedes recibir pagos fácilmente a través de Lightning Network y conectarlo a tu tienda en BTCPay Server.

Si tienes dudas sobre cómo crear tu cuenta en LNbits, puedes consultar el siguiente tutorial: https://cuba-bitcoin.github.io/tutoriales/lnbits.html

Si ya dominas el proceso, sigamos adelante.

Una vez que hayas ingresado a tu cuenta en LNbits, dirígete a la sección de Extensions y activa LndHub.

Una vez en LndHub, selecciona la billetera en la que recibirás los pagos y haz clic en COPY LNDHUB ADMIN URL para copiar el contenido.

Regresa a BTCPay Server y, en el Dashboard, selecciona Set up a Lightning node para comenzar la configuración.

Pega el contenido que copiaste de la extensión LndHub en el campo debajo de Connection configuration for your custom Lightning node.

Selecciona Test connection y, si ves el mensaje "Connection to the Lightning node successful...", significa que la conexión se ha realizado correctamente.

Selecciona Save en la esquina inferior y tienes la tienda lista y configurada para recibir pagos.

En la instancia de BTCPay Server de Cuba Bitcoin, tienes la libertad de elegir el método de integración que mejor se adapte a tus necesidades. Usar LNbits de Cuba Bitcoin te ofrece una opción enfocada en las necesidades de la comunidad, pero siempre es recomendable explorar y hacer tu propia investigación para encontrar lo que mejor funcione para ti.

4. Creación de una tienda con BTCPay Server

Este capítulo guiará a los usuarios en el proceso de crear una tienda en BTCPay Server, desde la configuración inicial hasta la gestión de pagos.

4.1 Configuración inicial y opciones de personalización

1. En el menú lateral izquierdo, selecciona PLUGINS y luego elige la opción Point of Sale (Punto de Venta).
2. Verás la opción Create a new Point of Sale.
   • En AppName, ingresa el nombre que desees para tu tienda.
     Por ejemplo: Alice Shop Havana.
   • Haz clic en Create para crear tu Punto de Venta.

Una vez creado, deberías ver algo similar a la siguiente pantalla.

3. Verás la opción Choose Point of Sale.
   Para este ejemplo, seleccionaremos Product list with card, aunque puedes cambiar esto más adelante según tus preferencias.

4. En el campo Description, puedes agregar una breve descripción de tu tienda o de los productos ofrecidos.
   Esto es útil para compartir información adicional con los clientes (opcional).

Gestión del inventario

• En Update Point of Sale, puedes gestionar el inventario de tu tienda.
• Por defecto, BTCPay Server incluye un inventario de ejemplo (como una tienda de té).

Se puede agregar, editar o eliminar productos:

Para eliminar un producto: haz clic en la X al lado del producto.

Para agregar un producto nuevo: haz clic en Add item.

Al agregar un producto, encontrarás los siguientes campos:

• Title: Nombre del producto.
• ID: Si lo dejas en blanco, se generará automáticamente desde el título.
• Precio:
  • Fixed: el cliente debe pagar exactamente ese monto.
  • Custom: el cliente elige cuánto pagar (ideal para donaciones).
  • Minimum: monto mínimo aceptado en modo Custom.
• Imagen: Puedes subir una imagen del producto (usa Upload).
• Descripción: Detalles adicionales del producto.
• Categorías: Agrupa los productos por categoría.
• Inventario: Deja en blanco para no gestionarlo. Si lo llenas, puedes controlar cantidades disponibles.
• Texto del botón de compra: Personaliza con mensajes como “Comprar ahora”, “Donar”, etc.
• Habilitar/Deshabilitar: Controla si el producto está visible o no en tu tienda.

Ejemplo:

• Producto: Guayabera con el logo de Bitcoin
• Categoría: Ropa
• Precio: 10 USD
• Inventario: 20 unidades

Cuando termines de agregar un producto, haz clic en Apply.

Puedes seguir agregando más productos o servicios. Cuando termines, selecciona Save para guardar el estado de tu tienda.

Solicitar datos de envío

Si tu tienda ofrece envíos a domicilio, puedes pedir los datos del destinatario.

1. En la pestaña Checkout, busca la opción
   Request customer data on checkout.
2. Selecciona Request shipping address.
3. Haz clic en Save (en la parte superior).

Visualizar tu tienda

Haz clic en View para ver cómo luce tu tienda.

Realizar una compra

1. Selecciona los artículos que deseas comprar.
   Por ejemplo:
   • Taza de Café Maxi de LA ISLA BTC
   • T Shirt Multicolor

2. Haz clic en Pay para procesar el pago.

3. Si seleccionaste previamente solicitar datos de envío, verás un formulario a completar.

4. Realiza el pago usando Bitcoin Lightning y ¡listo!

¡Has hecho tu primera venta en BTCPay Server!

Puedes acceder a la tienda creada por el siguiente enlace:

https://btcpay.cubabitcoin.org/apps/2nSap9K8BsJ1xhGWnktf29F8pUyB/pos

NO VAYAS A COMPRAR NADA — SOLO TIENE CARÁCTER EDUCATIVO

4.2 Opciones adicionales de pago

Una vez que tengas tu tienda lista, es probable que algún cliente prefiera pagarte con esa "shitcoin" que está de moda, impulsada por el último youtuber, el presidente de los Estados Unidos o incluso Elon Musk, en lugar de usar el mejor dinero del mundo.

Como buen vendedor, tú podrás ofrecer lo que desea sin necesidad de involucrarte directamente con esa criptomoneda. ¿Cómo lo lograrás? Vamos a verlo:

1. Ve al menú PLUGINS y selecciona FixedFloat.

2. Activa la opción Enable.

3. Haz clic en Save para guardar los cambios.

Ahora, al momento de pagar en tu tienda, los clientes verán dos opciones:

• Pagar directamente con una invoice de Lightning.
• Usar la nueva alternativa FixedFloat.

El proceso es simple: Nos dirigimos a la tienda, elegimos los productos que queremos y, al momento de pagar, nos encontramos con dos opciones: pagar directamente con una invoice de Lightning o usar la nueva alternativa Fixed Float. Solo copiamos la invoice a pagar, elegimos la shitcoin en la que queremos enviar, y listo. Así de fácil, estamos aceptando pagos en cualquier cripto, mientras seguimos recibiendo el mejor dinero del mundo: Bitcoin.

4.3 Formulario personalizado

Si los formularios predeterminados no se ajustan a lo que necesitas, no te preocupes.
BTCPay te permite crear y personalizar tu propio formulario. Aquí te explicamos cómo:

1. Ve a Settings.
2. Selecciona la pestaña Form.

3. Haz clic en Create Form para diseñarlo a tu gusto.

Al agregar un campo al formulario, debes definir:

• Type: el tipo de dato (texto, número, contraseña, email, etc.).
• Label: el nombre visible que verá el cliente en el formulario.
• Name: el nombre interno que usarás para identificar ese campo.
• Required field: puedes marcarlo para que sea obligatorio.

Puedes añadir todos los campos que necesites, personalizando el formulario según las necesidades específicas de tu tienda.

Vincular tu formulario a la tienda

1. Una vez guardado el formulario, ve a Point of Sale.
2. Selecciona la tienda a la que deseas agregar el formulario.
3. En la sección Checkout, selecciona el nombre de tu formulario personalizado.

Tu tienda ahora cuenta con un formulario hecho a la medida.

4.4 - Roles

En BTCPay Server, los roles son permisos asignados a diferentes usuarios que determinan qué acciones pueden realizar dentro de la plataforma. Cada rol tiene acceso a funciones específicas de la tienda y el servidor. Los roles permiten administrar de manera eficiente quién puede modificar configuraciones, gestionar pagos, ver información sensible, y más.
En BTCPay Server, los roles por defecto son Owner, Manager, Employee y Guest tienen diferentes niveles de acceso y permisos dentro de la plataforma. Aquí te explico lo que puede hacer cada uno:

Owner (Propietario):

• Tiene control total sobre la tienda y la configuración del servidor.
• Puede modificar todos los ajustes de la tienda, incluidas las configuraciones globales.
• Puede ver, modificar y eliminar facturas, pagos, solicitudes y configuraciones.

Manager (Gerente):

• Tiene acceso para gestionar la tienda, pero con permisos más limitados que el propietario.
• Puede ver y modificar facturas, solicitudes de pago, webhooks, pagos y configuraciones específicas de la tienda.
• No tiene acceso completo a las configuraciones del servidor ni la posibilidad de realizar cambios a nivel global.

Employee (Empleado):

• Permisos más restrictivos.
• Puede visualizar y modificar facturas, solicitudes de pago y pagos, pero no puede realizar cambios críticos en la tienda.
• No tiene acceso a configuraciones globales o ajustes de la tienda en su totalidad.

Guest (Invitado):

• Este rol tiene permisos muy limitados, generalmente solo para ver información pública.
• No puede realizar cambios en la tienda ni ver información sensible como pagos o facturas.
• Ideal para usuarios que solo necesitan acceso para visualizar la tienda sin permisos de gestión.

Para ver los detalles de los roles en BTCPay Server, debes dirigirte a Settings y luego seleccionar Roles. Allí podrás ver los roles que tienes por defecto. Además, si necesitas personalizar los permisos, tienes la opción de Add Role, que te permite crear un rol nuevo y asignarle los permisos que consideres necesarios según las necesidades de tu tienda.

Para añadir roles de usuario en BTCPay Server, debes ir a Settings y luego al apartado de Users. Allí verás la opción de añadir el correo electrónico de tu empleado y asignarle el rol correspondiente. Al hacerlo, podrás darle el nivel de acceso adecuado según el rol que se le asigna, ya sea Owner, Manager, Employee u otro rol personalizado que hayas creado. Esto facilita la gestión de permisos y asegura que cada usuario tenga el acceso necesario para su función dentro de la tienda.

4.5 - Crowdfund

Un Crowdfund (o crowdfunding) es un método de financiamiento colectivo en el que varias personas contribuyen económicamente a un proyecto, empresa, causa o producto a través de pequeñas aportaciones. Este método es muy usado para lanzar nuevos productos, apoyar causas sociales, financiar startups y proyectos creativos.

En BTCPay podemos crear nuestra propia campaña. Solo debemos dirigirnos al apartado de
PLUGINS y seleccionar Crowdfund.

En la sección "Create a New Crowdfund", debemos ingresar el nombre de nuestro proyecto. Para este ejemplo, crearemos un crowdfund para un proyecto de protección animal llamado "Un Hogar para Cada Huella".

Una vez creado, debemos completar los datos requeridos. Display Title es el título que se mostrará en la página, mientras que Tagline es el lema del proyecto. También podemos añadir una imagen representativa del proyecto. Además, tenemos la opción de hacer que el crowdfund sea público.

Podemos añadir una descripción a nuestro proyecto en Description, en la cual detallamos su propósito, los objetivos que buscamos alcanzar y el impacto que tendrá. Es importante que la descripción sea clara, inspiradora y transmita a los potenciales donantes por qué su apoyo es fundamental.

Podemos añadir Perks en nuestro crowdfund. Estos son una recompensa o beneficio para los donantes, como una forma de agradecer su apoyo y motivarlos a contribuir. Los perks pueden incluir productos exclusivos, menciones especiales, experiencias o cualquier incentivo relacionado con el proyecto.

En la sección de Goal del crowdfund, establecemos el monto objetivo Target Amount y la moneda en la que se recaudarán los fondos. Si lo deseamos, también podemos definir una fecha de inicio y finalización para la campaña.

En Contributions (Contribuciones) tenemos las siguientes opciones:

• Ordenar los perks de contribución por popularidad.
• Mostrar el ranking de contribuciones.
• Mostrar el valor de las contribuciones.
• No permitir contribuciones adicionales después de alcanzar la meta (desactivado, lo que significa que se permitirán contribuciones extra).

Crowdfund Behavior (Comportamiento del Crowdfund)

• Contar todas las facturas creadas en la tienda como parte del objetivo.

Adicionalmente, contamos con la opción de Checkout, que nos permite recopilar información de los donantes si es necesario. Esto puede incluir detalles como su nombre, correo electrónico o cualquier otro dato relevante para la campaña. Esta información puede ser útil para enviar agradecimientos, actualizar información sobre el progreso del proyecto o gestionar recompensas (perks).

Y tenemos lista nuestra campaña:
Puedes acceder a la campaña creada por el siguiente enlace:
https://btcpay.cubabitcoin.org/apps/2eEBDdwVo6DU9MrNkLRU6tEjgALB/crowdfund

NO VAYAS A DONAR NADA, SOLO TIENE CARÁCTER EDUCATIVO

5 - Accediendo al servidor desde Cuba

En este capítulo exploraremos cómo acceder a BTCPay Server desde Cuba y si existen restricciones que puedan afectar su uso.

5.1 - ¿Existen restricciones de acceso?

En Cuba, el acceso a servicios internacionales puede verse afectado por limitaciones en la infraestructura de internet. Sin embargo, BTCPay Server ofrece una alternativa para que comerciantes y usuarios puedan recibir pagos en Bitcoin de forma sencilla y rápida. Las comisiones del servicio dependen del nodo Lightning al que el comerciante decida conectarse.

5.2 - ¿Es necesario usar VPN o Tor?

No es estrictamente necesario usar VPN o Tor para acceder al servidor de BTCPay de Cuba Bitcoin. Sin embargo, el uso de VPN o Tor es una buena práctica en términos de privacidad y seguridad. En algunos casos, debido a la velocidad de internet en Cuba, puede ser necesario omitir su uso para una experiencia de usuario más fluida.

Si deseas acceder al BTCPay de Cuba Bitcoin a través de Tor, puedes hacerlo mediante el siguiente enlace:
https://ovogendhlbsjnchomgigp5ndjjdrwpp27jiwn3cqkmlvrzh5y3tnbuqd.onion

Recuerda que debes utilizar el navegador Tor Browser para abrir este enlace:
-Español
-Inglés

6. ¿Cómo puedes ayudar a la comunidad?

Puedes contribuir a la comunidad de Cuba Bitcoin de diversas maneras para fortalecer el uso de Bitcoin y Lightning Network en el país. A continuación, te mostramos algunas formas en las que puedes apoyar:

6.1 Donaciones para sostener el servicio:

El mantenimiento y funcionamiento de un servidor dedicado a BTCPay Service, LNBits y el Nodo de Lightning de Cuba Bitcoin requiere recursos y tiempo constantes. Las donaciones son esenciales para asegurar que este servicio siga disponible para todos los usuarios. Con tu contribución, por pequeña que sea, podremos cubrir gastos como el mantenimiento del servidor, las actualizaciones de seguridad, los costos operativos, la apertura de nuevos canales que mejoren la experiencia del usuario, la reducción de comisiones en las transferencias y la capacidad de aceptar pagos.

Las donaciones se pueden realizar a través de Bitcoin Lightning. Puedes donar a:

• cubabitcoin@lnbits.cubabitcoin.org
• cubabitcoin@walletofsatoshi.com

Muchas gracias.

6.2 Reporte de errores y sugerencias de mejora en la plataforma:

Tu participación en la mejora continua de la plataforma es muy importante para nosotros. Si encuentras errores o tienes ideas para mejorar el funcionamiento de BTCPay no dudes en reportarlos. Tu retroalimentación nos permite corregir fallos, mejorar la experiencia del usuario y mantener la plataforma eficiente y segura.

Puedes enviar tus reportes de errores y sugerencias comunicándote con los administradores en el grupo de Telegram de Cuba Bitcoin (Link). Toda colaboración es bienvenida y contribuye a fortalecer el proyecto.

6.3 Participación en la educación y difusión sobre Bitcoin en Cuba

La educación es el pilar fundamental de nuestra comunidad. Difundir el conocimiento sobre Bitcoin es clave para fomentar su adopción tanto en Cuba como en el resto del mundo. Puedes contribuir compartiendo tus conocimientos sobre esta tecnología, organizando talleres, charlas o simplemente difundiendo información clara y precisa sobre su funcionamiento. Al hacerlo, ayudarás a empoderar a más personas para que aprovechen los beneficios de Bitcoin en su vida diaria. Si deseas organizar un taller, meetup o clase en tu comunidad, puedes contar con el apoyo y la experiencia de la comunidad Cuba Bitcoin.

Además, puedes colaborar creando contenido educativo, compartiendo recursos o participando en actividades comunitarias. Síguenos en nuestras redes sociales y apóyanos con un "like" o un "retweet". Tu apoyo ayuda a que nuestro trabajo educativo llegue a más personas.

Redes sociales:

• X: Cuba_BTC
• Nostr:
  • NPUB: npub1huyn6ru55pv6l7p0sxvlu3vfpq7pan958sl4weft0kte6lvdvvksd5s34t
  • NIP05:
  • cubabitcoin@btcpay.cubabitcoin.org

7 - Conclusión

A lo largo de este tutorial, hemos explorado cómo BTCPay Server se puede utilizar como una herramienta poderosa para facilitar pagos en Bitcoin. En esta sección, discutiremos los próximos pasos para continuar promoviendo su uso y evolución, así como cómo puede adaptarse aún más a las necesidades de los usuarios cubanos y de la región.

7.1 - Próximos pasos y cómo BTCPay Server puede seguir evolucionando en la comunidad

BTCPay Server ha demostrado ser una solución eficiente para recibir pagos en Bitcoin de manera descentralizada y segura.

Los próximos pasos incluyen mejorar la educación sobre su uso, continuar con la integración de nuevas funcionalidades y trabajar en facilitar el acceso a más personas, a pesar de las posibles restricciones de acceso a internet.

A medida que la comunidad crezca, BTCPay Server seguirá evolucionando, adaptándose mejor a las necesidades locales y fortaleciendo aún más el ecosistema de Bitcoin en Cuba y el mundo.

Autores:

Forte11 y BTCLNAT

Forte11

Sígueme en X: https://x.com/Forte11Cuba

Sígueme en Nostr:

• npub1f0rtesc8yd8utjhpgktlltv4t2rftxd5kmkagt5kymt8946pqf7qe90snx
• forte11@cubabitcoin.org

Regálame un cafecito con Lightning Network: forte11@lnbits.cubabitcoin.org

BTCLNAT

Sígueme en X: https://x.com/delgadoamaran
Sígueme en Stackers News: https://stacker.news/BTCLNAT

Sígueme en Nostr:

• npub1dhttjg8sjk4arx0qywsu9s7c09sxagrz5kktvsl78dfqwy9er
• BTCLN@btcpay.cubabitcoin.org

Regálame un cafecito con Lightning Network: btclnat@lnbits.cubabitcoin.org

Cashu Básico

1. Introducción
   1.1. Breve historia del protocolo
   1.2. Contexto actual de Cuba e importancia de Cashu para la comunidad
2. Conceptos básicos de Cashu
   2.1. ¿Qué son los mints?
   2.2. ¿Qué son los tokens Cashu?
   2.3. ¿Cómo funcionan los pagos offline?
   2.4. Flujo básico
3. Configuración inicial de Cashu
   3.1. Instalación de una wallet compatible
   3.2. Guardando la semilla
   3.3. Conexión a un mint Cashu
4. Uso básico de Cashu
   4.1. Creación de tokens Cashu
   4.2. Enviar pagos con Cashu
   4.3. Recepción de tokens Cashu
   4.4. Verificación del saldo
   4.5. Intercambiar tokens entre mints (Swaps)
5. Integraciones con la comunidad Cuba Bitcoin
   5.1. Ejemplos de uso en comercios locales
   5.2. Facilidad de pago para viajeros
6. Retos y soluciones
   6.1. Restricciones de conectividad
   6.2. Alternativas para usar Cashu sin internet constante
   6.3. Confianza en el Mint
   6.4. Riesgos de recibir pagos sin conexión
7. Cómo contribuir a la comunidad
   7.1. Difusión de Cashu en Cuba
   7.2. Reporte de problemas y sugerencias
   7.3. El futuro de Cashu en la comunidad Cuba Bitcoin

1 - Introducción

Hola. Estamos muy contentos de compartir este tutorial sencillo sobre Cashu Básico, creado con cariño por el equipo de Cuba Bitcoin. En los últimos meses, Cuba ha enfrentado cortes eléctricos que han dejado sin funcionar cajeros, plataformas de pago y, a las pocas horas, el internet. En un entorno tan desafiante, encontramos en Cashu una solución increíble. Estás a punto de conocer un protocolo que permite hacer pagos con Bitcoin incluso sin conexión a internet. En este tutorial, te guiaremos paso a paso para que, sin complicaciones ni tecnicismos, puedas usarlo y contribuir a un comercio más fuerte y resiliente. Veremos como Cashu puede cambiar las reglas del juego.

1.1 - Breve historia del protocolo

El protocolo Cashu es una implementación moderna de eCash, un concepto de dinero digital creado en 1982 por el criptógrafo David Chaum, quien introdujo las firmas ciegas para garantizar transacciones privadas. Aunque su empresa DigiCash intentó integrarlo en los años 90, la dependencia de sistemas bancarios centralizados lo llevó al fracaso.

Puedes profundizar más en eCash con este pod de Lunatcoin:
Creación y evolución del eCash: Chaumian Mints, Fedimint y Cashu

Con Bitcoin, creado por Satoshi Nakamoto en 2009, nació una forma descentralizada de revivir eCash. En octubre de 2022, un desarrollador llamado Calle lanzó Cashu, un protocolo que combina la privacidad de eCash con la velocidad de la red Lightning de Bitcoin, permitiendo hacer pagos rápidos, privados y, lo mejor, sin necesidad de internet, ideal para Cuba frente a cortes eléctricos y de conexión. Con Cashu, puedes "tokenizar" satoshis en tu celular a través de las Casas de la Moneda o los Mints, lugares que emiten estos tokens, algo que explicaremos más adelante.

1.2 - Contexto actual de Cuba e importancia de Cashu para la comunidad

En los últimos meses, Cuba ha enfrentado constantes apagones que limitan la electricidad a solo 1 a 4 horas al día en muchos pueblos, y la conexión a internet, cuando existe, es intermitente y más lenta que 1 Mbps. A esto se suman cuatro cortes masivos del sistema eléctrico nacional entre octubre de 2024 y marzo de 2025, que han paralizado el país: los cajeros automáticos dejan de funcionar, las aplicaciones bancarias colapsan y el internet desaparece en pocas horas. Es una realidad dura, donde el comercio y la vida cotidiana se detienen por completo. Frente a este desafío, el equipo de Cuba Bitcoin buscó soluciones para mantener el comercio vivo incluso sin electricidad ni internet. Después de evaluar varias opciones, elegimos Cashu, un protocolo que nos permite hacer pagos con Bitcoin usando solo un celular con batería. Con Cashu, las transacciones son rápidas, privadas y no dependen de bancos o conexión a internet. Esto significa que, aunque todo falle, puedes seguir comprando y vendiendo. Cashu no es solo un protocolo, es una forma de empoderar al pueblo cubano.

Nota: Puedes consultar más sobre los cortes eléctricos en noticias oficiales del gobierno de Cuba:

Octubre 2024
Noviembre 2024
Diciembre 2024
Marzo 2025

2 - Conceptos básicos de Cashu

En este capítulo entenderás algunos conceptos básicos sobre el funcionamiento de Cashu antes de empezar con la parte práctica de este tutorial. Aquí te explicamos tres ideas clave del protocolo.

2.1 - ¿Qué son los mints?

Un mint o Casa de la Moneda es como un casino que cambia tus satoshis (sats) por fichas digitales, llamadas tokens Cashu, que representan su valor. También puedes pensar en una tienda comunitaria que te da vales para comprar, respaldados por el dinero que entregaste. El dinero papel representó un pagaré o promesa de pago por oro. En Cashu, los mints son operados por personas o comunidades de confianza y usan la red Lightning para garantizar que tus tokens estén respaldados por Bitcoin.

Casa de la moneda de Cuba Bitcoin en dónde no se acuñan monedas, se acuñan nueces.

2.2 - ¿Qué son los tokens Cashu?

Los tokens Cashu son como billetes digitales que representan satoshis, la unidad más pequeña de Bitcoin. Imagina que tienes vales electrónicos en tu celular, firmados criptográficamente por un mint, que puedes usar para pagar en una tienda sin necesidad de papel. Estos tokens te permiten hacer pagos rápidos y privados, ya que nadie puede rastrear quién los envió o recibió.

2.3 - ¿Cómo funcionan los pagos offline?

Los pagos offline con Cashu funcionan porque los tokens Cashu están guardados directamente en tu celular, como si llevaras billetes en tu bolsillo. Estos tokens son seguros porque el mint los firma digitalmente, garantizando que son válidos. Para pagar, solo necesitas compartir tus tokens con otra persona, por ejemplo, escaneando un código QR o enviando un texto corto con una aplicación de billetera Cashu. Una vez que tengas conexión de nuevo al mint, este verifica los tokens para asegurar que todo esté en orden.

2.4 - Flujo básico

El siguiente diagrama muestra cómo funciona de forma básica la emisión y transferencia de Cashu:

1. Envío de sats al Mint: El usuario envía sats al Mint a través de la red Lightning.
2. Emisión de tokens Cashu: El Mint recibe los sats y, a cambio, emite tokens Cashu equivalentes, que entrega al usuario.
3. Transferencia entre personas: El usuario puede transferir sus tokens Cashu a otra persona. Esta puede guardarlos en su dispositivo, usarlos para pagar a otra persona o canjearlos por sats nuevamente vía Lightning.

Este sistema permite transferencias privadas, instantáneas y sin necesidad de una conexión directa entre el emisor y el receptor.

3 - Configuración inicial de Cashu

En este capítulo, explicaremos los pasos esenciales para comenzar a usar Cashu. Aprenderás cómo configurar una wallet y conectarla a un mint específico. Esta configuración inicial es el primer paso para aprovechar este protocolo en tu comunidad.

3.1 - Instalación de una wallet compatible

Hay varias carteras (wallets) que funcionan con el protocolo de Cashu, pero para aprender lo básico vamos a usar una bien sencilla y accesible: cashu.me
Solo tienes que abrir el navegador de tu teléfono o computadora y entrar a esa dirección.

Una vez ahí, verás un botón que dice “Next”. Dale clic para seguir avanzando.

En esta parte, la página te cuenta que se trata de una PWA (Progressive Web App), que es como una mezcla entre página web y aplicación. Puedes instalarla como si fuera una app normal en tu dispositivo.
Para hacerlo, toca los tres punticos (⋮) que están en la esquina superior derecha del navegador y selecciona la opción que dice “Agregar a pantalla de inicio” o “Add to Home screen” (depende del idioma de tu navegador). Luego confirma que quieres instalarla.

Ahora tienes una aplicación de Cashu directamente en tu teléfono, lista para usar como cualquier otra app.

3.2 - Guardando la semilla

Una vez sigamos avanzando en la app, nos va a mostrar 12 palabras. Estas son muy importantes ya que son la clave para entrar a tu cartera y recuperar tus monedas si pierdes el teléfono o cambias de dispositivo. Tienes que guardarlas en un lugar seguro, fuera del teléfono si es posible. Escríbelas en un papel, guárdalas en una libreta. No las pierdas ni las compartas con nadie.
Para ver las palabras, toca el ícono del ojito que aparece en la pantalla.

Después que las hayas copiado bien, marca la casilla que dice “I have written it down” (ya las escribí) y dale al botón Next para continuar.

3.3 - Conexión a un mint Cashu

El siguiente paso es conectarnos a un Mint, también conocido como una Casa de la Moneda. Este es un componente clave en el uso de Cashu, porque es el encargado de emitir y verificar los tokens que vas a usar.
El Mint que elijas debe ser de tu confianza. Estás confiando en él para que cuide tu dinero y emita tokens válidos. Si el mint promete entregar tokens respaldados 1 a 1 con sats reales, entonces funciona como un banco de reserva completa: no presta tu dinero, simplemente lo guarda y lo respalda con bitcoin. También existen otros tipos de mints llamados Stable Mints, los cuales emiten tokens que representan monedas fiat como el dólar (USD). En ese caso, tus tokens estarían representando en valor 1 a 1 con USD, pero eso ya es otro tema que se escapa del objetivo de este tutorial.
Ahora vamos a agregar el mint de Cuba Bitcoin pensado para nuestra realidad.
Para eso, en la aplicación, buscamos la opción que dice “ADD MINT”.
Vamos a adicionar el mint de Cuba Bitcoin. Para ello vamos hasta el apartado de “ADD MINT”.

En el primer campo, escribimos la dirección del mint:
https://mint.cubabitcoin.org
Luego, donde dice “Nickname”, puedes poner el nombre que tú prefieras. Por ejemplo, le puedes poner “Cuba Bitcoin” para identificarlo fácilmente.

Ya tienes tu mint conectado. Ahora sí estás preparado para empezar a usar tus tokens Cashu.

4 - Uso básico de Cashu

Ahora que ya tienes tu wallet instalada y conectada a un mint, es hora de poner Cashu en acción.
En este capítulo, vamos a cubrir lo esencial para que puedas moverte con confianza: cómo recibir tokens, cómo enviarlos a otra persona y cómo verificar tu saldo.
Aquí es donde empieza la verdadera magia de este protocolo: dinero digital, rápido, privado y fácil de usar. Además, veremos en qué momentos necesitarás conexión a internet y en cuáles podrás operar sin ella.

4.1 - Creación de tokens Cashu

Recuerda que para que el mint te cree tokens Cashu, primero necesitas enviar Bitcoin a través de Lightning Network.

Primero, abre la opción Receive (Recibir) en tu wallet y selecciona Lightning como método de pago.

Luego, selecciona el mint al que vas a enviar los fondos. En este ejemplo, vamos a usar Cuba Bitcoin. Después, agrega la cantidad de sats que deseas enviar.

Una vez tengas todo listo, simplemente paga la invoice (factura) y listo, ya tienes tus primeros tokens Cashu minteados desde Cuba Bitcoin.

Importante: Para crear tokens Cashu, siempre necesitas estar conectado al mint. Sin conexión, no podrás generar nuevos tokens.

4.2 - Enviar pagos con Cashu

Para enviar tokens Cashu, abre la opción Send (Enviar) en tu wallet y selecciona eCash como método de pago.

Luego, elige el mint desde el cual quieres enviar los tokens.
Importante: Este paso lo puedes hacer incluso sin conexión a internet. Tú puedes estar completamente offline al generar el pago.

Después de eso, se genera un código QR que la otra persona puede escanear para recibir los tokens. También puedes copiar la información y enviarla por otro medio, como un SMS si no dispones de internet.

Y así, de forma rápida y sencilla, puedes enviar tokens Cashu.

4.3 - Recepción de tokens Cashu

Para entender bien cómo funciona la recepción de tokens Cashu, te recomendamos hacer una pequeña simulación. Puedes crear una wallet en otro dispositivo usando una clave diferente, o simplemente utilizar otra wallet compatible de Cashu en el mismo dispositivo.
Primero, abre la opción Receive (Recibir) en tu wallet y selecciona eCash como método de pago.

Luego, tienes varias formas de ingresar el pago: puedes pegar el mensaje, escanear un QR, e incluso usar NFC (si tu dispositivo lo permite).
Ten en cuenta que esta app funciona como una PWA (aplicación web progresiva), por lo que en algunos dispositivos ciertas funciones podrían comportarse de forma diferente por temas de compatibilidad.

Una vez ingresado el token, la wallet te mostrará tres opciones:
Receive (Recibir)

Later (Más tarde)

Close (Cerrar)

Si no tienes acceso a internet en ese momento, puedes elegir la opción Later, y el token quedará guardado para ser reclamado más adelante.
Cuando usas la opción Later, la transacción pendiente aparece en la sección History.

Al ir a History, verás la transacción guardada con un iconito de una flecha hacia abajo al lado derecho.

Si presionas esa flecha, la wallet te mostrará los detalles de la transacción y te dará la opción de presionar Receive.
Si en ese momento tienes conexión a internet, podrás reclamar los tokens y verás un cartel verde en la parte superior confirmando que han sido recibidos con éxito.

Y así, podemos recibir tokens Cashu, incluso si estás offline al principio.

4.4 - Verificación del saldo

Después de recibir o enviar tokens, es normal que te preguntes: “¿Cuánto me queda?”
Para revisar el saldo solo tienes que abrir tu wallet y, en la pantalla principal, verás el saldo total disponible, dividido por cada mint que tengas agregado.
Esto te permite saber cuántos sats tienes y en qué mint están respaldados.
Recuerda que para ver el saldo actualizado necesitas conexión al mint correspondiente. Si estás sin internet, verás el saldo estimado según tus últimas operaciones, pero no se actualizará hasta reconectarte.

4.5 - Intercambiar tokens entre mints (Swaps)

Si en algún momento decides cambiar de casa de la moneda (mint), ya sea por confianza, necesidad o simple curiosidad, puedes hacer un swap o intercambio entre mints.

En tu wallet de cashu.me, encontrarás una sección llamada Discover mints. Al hacer clic en la opción “Click to browse mints”, se abrirá una lista de mints publicados en la página bitcoinmints.com, todos con al menos una reseña o evaluación.

Para este ejemplo, vamos a añadir el mint de Minibits, un proyecto muy sólido que incluso tiene su propia billetera. Te recomendamos explorarlo por tu cuenta si te interesa.

Es importante tener claro que los tokens Cashu no son interoperables entre mints distintos. Cada mint emite sus propios tokens y no reconoce los de otros. Por eso, el proceso de intercambio se hace en tres pasos:

1. Envías tus tokens Cashu al mint actual (en este caso, Cuba Bitcoin).
2. El mint los quema (los destruye) y, usando la red Lightning, envía los sats al nuevo mint.
3. El nuevo mint (por ejemplo, Minibits) recibe los sats y genera nuevos tokens Cashu que te entrega.

Una vez que hayas añadido el mint de destino, ve a la opción Swaps en la wallet. En nuestro ejemplo, vamos a enviar desde Cuba Bitcoin hacia Minibits.
En la opción From, seleccionamos Cuba Bitcoin, y en To, seleccionamos Minibits. Luego indicamos la cantidad a enviar. Para este ejemplo, probaremos con 21 sats.

Le damos al botón de Swap, y listo. En la parte superior de la wallet verás el resumen: cuánto se envió, cuánto se recibió y si hubo comisión.
Este proceso se hace usando Lightning Network, que a veces cobra una comisión dependiendo de cómo se enrute el pago.
Y así, fácil y rápido, ya tienes tus nuevos tokens en otro mint.

5 - Integraciones con la comunidad Cuba Bitcoin

En este capítulo vamos a explorar cómo Cashu puede integrarse en el día a día de nuestra comunidad, especialmente en entornos donde el acceso a internet, los servicios bancarios y el efectivo son problemáticos. Veremos ejemplos concretos de cómo esta tecnología puede facilitar la vida cotidiana de comerciantes y usuarios en Cuba.

5.1 - Ejemplos de uso en comercios locales

Cuba enfrenta una combinación compleja de desafíos: apagones frecuentes, internet inestable y una crisis de efectivo persistente. Además, las aplicaciones bancarias oficiales funcionan de manera irregular, lo que complica aún más las transacciones cotidianas.
En este contexto, Cashu ofrece una alternativa poderosa y simple. Al aceptar pagos con tokens Cashu, los comerciantes se liberan de varias limitaciones:

• No dependen de servicios bancarios frágiles.
• Pueden recibir pagos incluso sin conexión inmediata a internet.
• Ofrecen a sus clientes una vía de pago rápida, privada y sin fricción.

Cashu es ideal para sobrevivir (y prosperar) en un entorno tan caótico como el cubano.

5.2 - Facilidad de pago para viajeros

Durante una lluvia de ideas del equipo de Cuba Bitcoin, a @hhobbitt (@hobbit9708) se le ocurrió una solución brillante para quienes visitan la isla:
mintear tokens Cashu desde el mint comunitario de Cuba Bitcoin antes de emprender su viaje.

Si el viajero se queda sin conexión a internet (algo bastante común en Cuba), o no logra conseguir una SIM cubana —que muchas veces es un dolor de cabeza—, igual podrá pagar bienes y servicios locales usando Cashu.

Gracias al diseño del protocolo, estos pagos pueden hacerse de forma offline, siempre que ambas partes tengan una wallet.

Para que este esquema funcione de manera fluida, los comerciantes locales deben:

• Conocer cómo funciona Bitcoin y Lightning Network.
• Estar dispuestos a aceptar pagos en Cashu, ya sea con su propio dispositivo o con una wallet compartida del negocio.
• Reclamar los tokens cuando tengan conexión a internet, si están offline en el momento del pago.

Esta propuesta abre la puerta a un ecosistema de pagos descentralizado, privado y sin fricciones, pensado tanto para turistas como para cubanos. Una alternativa realista y práctica frente al caos del efectivo, la mala conectividad y las limitaciones bancarias de la isla.

6 - Retos y soluciones

Usar Cashu en Cuba tiene sus particularidades. Aunque el protocolo fue diseñado para operar incluso con baja conectividad, existen retos reales que debemos considerar para sacarle el mayor provecho dentro del contexto cubano.
Y como en todo: para cada reto, existe una solución.
En este capítulo exploramos los obstáculos más comunes y compartimos buenas prácticas para enfrentarlos.

6.1 - Restricciones de conectividad

Cuba enfrenta serias limitaciones en cuanto a conectividad: zonas sin cobertura, conexiones lentas e inestables, y acceso irregular al internet móvil. Además, no todos los usuarios tienen datos móviles constantes ni acceso diario a una red Wi-Fi confiable. Estos factores pueden dificultar el uso fluido de herramientas digitales como Lightning o la conexión directa con un mint.

6.2 - Alternativas para usar Cashu sin internet constante

Cashu es una solución resiliente.
Una buena práctica, especialmente si formas parte de una comunidad que acepta Cashu, es mantener tokens listos para usar en caso de cortes prolongados de internet o apagones.
Supongamos que prevés que un apagón general puede durar hasta 5 días. Durante ese tiempo, estimas que gastarás unos 30 USD en productos básicos.
Esos 30 USD puedes tenerlos minteados en tu wallet de antemano, listos para usar en cualquier momento, sin depender de estar conectado.
Así, el comercio no se detiene. Tampoco la vida.

6.3 - Confianza en el Mint

Al usar Cashu, estás depositando tu confianza en el mint que emite los tokens, ya que este es el responsable de garantizar que estos sean válidos y estén respaldados por la cantidad correcta de Bitcoin.
Es fundamental elegir un mint que te ofrezca seguridad y confianza. El mint de Cuba Bitcoin es una excelente opción local, creado específicamente para nuestra comunidad, aunque también puede ser utilizado por personas de cualquier parte del mundo. No obstante, independientemente del mint que elijas, asegúrate siempre de que lo estén operando de manera ética.
Aunque los mints no son bancos tradicionales, su funcionamiento se asemeja al de un "banco de reserva completa", lo que significa que los tokens emitidos están respaldados 1:1 por Bitcoin. Esto garantiza que no se emiten más tokens de los que realmente existen en reserva.
Es recomendable que revises la reputación del mint que decidas usar, investigues las reseñas de otros usuarios y te mantengas al tanto de cualquier actualización relevante sobre su funcionamiento.

IMPORTANTE: Aunque Cashu es una excelente herramienta para realizar transacciones rápidas, privadas y offline, no está diseñado para almacenar grandes cantidades de dinero a largo plazo (aunque podrías hacerlo si lo deseas). El protocolo está pensado para facilitar transacciones cotidianas. Te recomendamos mantener solo la cantidad de tokens que necesites para tus pagos inmediatos o que sepas que vas a necesitar en un futuro cercano.

6.4 - Riesgos de recibir pagos sin conexión

Recibir tokens Cashu sin conexión puede ser una herramienta muy útil en entornos con internet inestable, pero también conlleva ciertos riesgos que debes tener en cuenta.
En el caso de Cashu.me, al ser una Progressive Web App (PWA), algunos dispositivos o navegadores pueden tener problemas para guardar datos offline de manera confiable.
Antes de usarlo en situaciones críticas, te recomendamos probar el flujo completo: "Receive", "Later", "History", "Receive". Además, asegúrate de utilizar navegadores recomendados, como Chrome o Firefox, para evitar posibles fallos.
Si encuentras problemas, considera probar otras wallets de Cashu, como Nutstash o Minibits.

Tu saldo mostrado offline es solo una estimación basada en tu última sincronización. Si haces varias transacciones sin reconectar, podrías quedarte sin ver que tu balance real es menor.
Mantén un colchón de tokens sin gastar para emergencias y evita quedarte a “cero” mientras sigues offline.

Cuando aceptas un pago en modo offline (usando la opción "Later"), ese token quedará marcado como pendiente en tu wallet hasta que restablezcas la conexión.
Por eso, es importante que revises regularmente la sección History de tu wallet y reclames los pagos tan pronto como tengas acceso a internet nuevamente.

Aunque el protocolo Cashu previene el doble gasto a nivel de mint, si compartes tu wallet con otras personas o usas un dispositivo que no es totalmente seguro, existe el riesgo de que te roben los tokens.
Es crucial que mantengas tu dispositivo protegido y nunca compartas tu seed phrase con nadie.

Al realizar un pago offline, no se obtiene una confirmación inmediata de que el vendedor haya recibido realmente el token.
Esto podría generar confusión si la otra persona no reclama el pago.
Para evitar malentendidos, es importante comunicar claramente el procedimiento: asegúrate de indicarle al vendedor cómo acceder y reclamar la transacción desde la sección History de su wallet, o incluso envíale el QR con instrucciones claras para que lo haga.

Uno de los riesgos de recibir pagos offline es que la persona que te envió el pago podría intentar usar el mismo token Cashu para pagar a otro comerciante o incluso intentar cobrarlo nuevamente.
Para prevenir esta situación, el comprador puede bloquear esos tokens utilizando tu clave pública en la aplicación o de tu perfil en Nostr.
Este procedimiento requiere estar conectado al mint para firmar el pago, pero para recibir y cobrar el pago en el futuro, no es necesario estar conectado en ese momento.
Si deseas profundizar en este aspecto de la firma de pagos, te invitamos a investigar más a fondo mientras preparamos un tutorial específico sobre este tema.

Si ambas partes están offline, la confianza mutua es crucial.
Es comparable a aceptar efectivo de un desconocido: ¿cómo puedes estar seguro de que los billetes son genuinos y no falsificados? ¿Revisan todos los comerciantes los billetes con cada venta?
Al final del día: “Todos los billetes son falsos”.

En economías circulares y comunidades bitcoiners, la confianza entre las partes es fundamental, aunque esto pueda parecer en contradicción con el principio "No confíes, verifica".
Como mencionó Lore Bitcoin, creadora del proyecto Embassy Bar, nunca tuvo problemas con pagos onchain de sus clientes.
En Bitcoin Berlín, muchos comerciantes locales tienen un QR impreso al que los compradores acceden, pagan y muestran el recibo de pago.
Muchos comerciantes venden sin verificar en su dispositivo.
Aunque los compradores podrían intentar hacer un replace by fee a Lore Bitcoin o falsificar una prueba de pago en Berlín, en la mayoría de los casos, existen valores éticos dentro de la comunidad bitcoiner, lo que minimiza estas posibilidades.

Sin embargo, nunca está de más recordar: "No confíes, verifica."

7 - Cómo contribuir a la comunidad

Este capítulo está destinado a todos aquellos que desean aportar a la comunidad de Cuba Bitcoin y, más específicamente, a la expansión del uso de Cashu en la isla. La colaboración y el intercambio de ideas son esenciales para fortalecer el ecosistema y facilitar la adopción de esta tecnología en entornos con desafíos tecnológicos y sociales como los que enfrentamos en Cuba.

7.1 - Difusión de Cashu en Cuba

Una de las formas más valiosas de contribuir a la comunidad es ayudar a expandir el uso de Cashu dentro de Cuba. Si ya lo usas y te ha resultado útil, tu experiencia puede motivar e instruir a otros.

Te invitamos a compartir tus vivencias y aprendizajes en redes sociales y espacios digitales, especialmente en comunidades interesadas en Bitcoin y herramientas de soberanía financiera. Crear contenido visual o educativo —como videos tutoriales, infografías o publicaciones explicativas— puede marcar una gran diferencia y hacer que más personas se animen a probarlo.

También puedes colaborar con otros miembros de la comunidad para crear puntos de ayuda o referencia local, donde los nuevos usuarios puedan resolver dudas, recibir asistencia para configurar sus wallets y comenzar a utilizar Cashu en su día a día.

Otra forma efectiva de difundir el conocimiento es organizando talleres, charlas o encuentros informales con comerciantes, vecinos o grupos afines. Ayudar a los vendedores con los que interactúas a entender cómo Cashu puede simplificar el cobro sin depender de la banca tradicional o plataformas móviles inestables es un paso muy valioso.

Si vives en Cuba, esta labor también puede ser parte de una estrategia preparacionista: educar a tu comunidad o tu círculo cercano para mantener el comercio funcionando incluso en un escenario de apagón general. En tiempos difíciles, el conocimiento compartido puede marcar la diferencia.

Si has tenido una buena experiencia utilizando el mint, te invitamos a dejar un comentario en bitcoinmints.com. Tu opinión puede ayudar a otros usuarios a conocerlo.

7.2 - Reporte de problemas y sugerencias

A medida que más personas comienzan a usar Cashu, es normal que aparezcan desafíos técnicos o ideas para mejorar. Una de las formas más importantes de fortalecer el ecosistema es compartiendo tus observaciones, fallos detectados o propuestas directamente con quienes desarrollan las herramientas.

Si encuentras errores en alguna wallet de Cashu, problemas con las transacciones o dificultades para usar ciertos mints, no dudes en reportarlo. Mientras más detalles puedas ofrecer —como el tipo de dispositivo, navegador, sistema operativo o versión de la wallet—, más fácil será reproducir el error y solucionarlo. Capturas de pantalla o descripciones paso a paso también son de gran ayuda.

Si tienes experiencia técnica, puedes ir más allá: colaborar directamente en el desarrollo del protocolo, participar en pruebas beta, proponer mejoras o contribuir con código, documentación o traducciones. Todo aporte suma.

Y si has encontrado soluciones a problemas frecuentes o descubriste una forma creativa de mejorar la experiencia con Cashu, compártela. Publica tus hallazgos, graba un video, escribe un mensaje en un grupo. Cada contribución fortalece a la comunidad. Somos parte de algo más grande, y cuando compartimos, todos ganamos.

7.3 - El futuro de Cashu en la comunidad Cuba Bitcoin

Cashu representa una herramienta poderosa para fortalecer la soberanía financiera y la resiliencia comunitaria. Su enfoque centrado en la privacidad, la facilidad de uso y la independencia de infraestructuras bancarias tradicionales lo convierten en una solución ideal para los desafíos que enfrenta nuestra comunidad.

El futuro de Cashu en la comunidad Cuba Bitcoin depende de nosotros: de la voluntad colectiva de aprender, compartir, construir y buscar soluciones en medio de un entorno caótico y hostil.
En contextos tan complejos como el cubano, si ves que alguien construye, déjalo construir. Aporta si puedes; si no, al menos, lo más sensato es no estorbar. Muchos se quejan y dicen que no se puede; unos pocos, en cambio, construyen.
Y al final, pese a todo, se logró: ¡Bitcoin sin internet!

Autor: Forte11

• Sígueme en X : https://x.com/Forte11Cuba
• Sígueme en Nostr:
  • npub: npub1f0rtesc8yd8utjhpgktlltv4t2rftxd5kmkagt5kymt8946pqf7qe90snx
  • NIP05: forte11@cubabitcoin.org

☕ Regálame un cafecito con Lightning Network:
forte11@lnbits.cubabitcoin.org