Primal 3.0 + Breez SDK: el motor Lightning que me faltaba en la historiaPrimal 3.0 + Breez SDK: el motor Lightning que me faltaba en la historia

Disclaimer: no tengo relación comercial con Primal ni con Breez. Esto es iniciativa propia. Haz tu propia investigación. #DIOR

Recapitulando la serieRecapitulando la serie

Esta es la tercera entrega de mi serie sobre Primal y onboarding Bitcoin para BPT. Si vienes llegando:

• Pieza 1: Primal 3.0.20: cuando una wallet de Nostr empieza a hablar BIP39. Ahí rastreé la pista técnica: la build iOS 3.0.20 mencionó "Self-custodial wallet" en una línea de release notes, y los repos de Android tenían commits de librerías de ACINQ (las mismas de Phoenix Wallet). Mi hipótesis fue: probablemente ACINQ por debajo. Cerré la pieza con tres pendientes: whitepaper, confirmación del esquema, FAQ de recuperación.
• Pieza 2: ¿Por qué elijo onboardear a la comunidad BPT con Primal?. Esa fue más pedagógica: por qué Primal reduce fricción al mínimo para alguien que entra desde cero. Prometí profundizar en wallet self-custodial, Lightning y Nostr en posts futuros.

Esta tercera pieza cierra la incógnita técnica de la pieza 1 y abre la rama Lightning prometida en la pieza 2 al mismo tiempo. Resulta que el motor LN no era ACINQ. Era Breez.

La noticiaLa noticia

El anuncio reciente sobre Primal en Nostr confirma que la wallet self-custodial de la app integra el SDK de Breez.

Lo que en marzo era una línea entre comillas, hoy tiene nombre: Breez SDK. Bienvenida la transparencia técnica.

Eso ajusta mi hipótesis original. La pista de las libs de ACINQ era buena, pero llevaba al lugar equivocado. La realidad es Breez, un nombre que viene resonando en el ecosistema desde hace años, pero que muchos asociamos solo con la app consumer Breez Wallet o con el POS de comercios.

Pero, ¿qué es un SDK?Pero, ¿qué es un SDK?

Antes de seguir, una pausa pedagógica. Si conoces Breez como wallet o como POS de pagos pero te perdiste en la palabra "SDK", esta sección es para ti. Yo mismo conozco Breez desde hace años como app, y la primera vez que leí "SDK" tuve que parar a entenderlo.

SDK = Software Development Kit. Es un kit de herramientas que un equipo construye y entrega a otros desarrolladores para que no tengan que reinventar la rueda.

Una analogía que me gusta: imagina que Breez construyó una cocina industrial completa: hornos, freidoras, conexiones de gas, todo profesional, todo testeado. En vez de venderte solo la comida en un restaurante, te alquila la cocina para que tú pongas tu menú, tu marca y tu atención al cliente. La cocina ya viene con todo; tú pones encima lo que te diferencia.

En términos técnicos: el SDK de Breez empaqueta toda la plomería de Lightning Network: nodo embebido, gestión de canales, integración con un LSP (Lightning Service Provider), swaps automáticos, recuperación, y se lo entrega a cualquier app que quiera tener wallet LN profesional sin contratar un equipo de desarrolladores Lightning.

¿Quién lo construyó? Breez Technology — el mismo equipo detrás de Breez Wallet. Tienen más de 5 años en el ecosistema.

Qué cambia para el usuario de PrimalQué cambia para el usuario de Primal

Hasta antes de esta integración, la situación era:

La consecuencia práctica: por primera vez puedes tener una sola app que es Nostr + LN + BTC bajo tu llave, sin tener que combinar Phoenix + Damus + BlueWallet. Eso es lo que hacía complicado el onboarding de un principiante.

El detalle que importa: las feesEl detalle que importa: las fees

Ningún motor Lightning es gratis, y aquí Breez tiene una pieza fina que conviene leer antes de poner sats; sobre todo, antes de recomendarle a un comercio que cobre con esto.

La variante del SDK que usa Primal es Breez SDK Liquid: rutea pagos LN a través de la sidechain Liquid (L-BTC) usando swaps automáticos. Eso le permite ofrecer self-custody sin que el usuario gestione canales propios, pero implica varias transacciones por debajo de la mesa.

Las fees principales (consultadas el 2026-04-28 en la documentación oficial, revisar antes de operar, esto no depende de Primal):

• Recibir LN: ~0.25% del monto + ~50 sats fijos.
• Enviar LN: ~0.1% del monto + ~50 sats fijos.
• Caso "Magic Routing Hint" (cuando la contraparte también usa Breez Liquid): fee 0.
• Cobro on-chain (BTC): ~2.000 sats + dependiente del mempool.

Para un café pagado en LN (10.000 sats), pagar ~72 sats de fee es prácticamente nada. Para un comercio que mueve millones de sats al mes, ese 0.25% importa — y abre la conversación sobre cuándo Breez ya no alcanza y conviene migrar a opciones tipo BTCPay self-hosted.

Pero esa conversación es para la próxima pieza de la serie.

Por qué esto importa para BPT (cerrando lo prometido en la pieza 2)Por qué esto importa para BPT (cerrando lo prometido en la pieza 2)

En la pieza 2 dije que mi objetivo es que cualquier persona de la comunidad sea nativa en Bitcoin desde el minuto 1. Hasta antes de la integración Breez SDK, "nativo" era un poco trampa: la wallet LN era custodial, los sats eran de Strike. La persona aprendía Lightning, pero no era dueña de sus sats.

Ahora sí. Primal con Breez SDK = self-custody desde el primer sat recibido.

Eso cambia la promesa de la clase de onboarding de 5 minutos:

• Antes: "vas a recibir tu primer sat en Lightning."
• Ahora: "vas a recibir tu primer sat en Lightning bajo tu propia llave."

La diferencia es enorme. Es la diferencia entre una experiencia y un acto de soberanía.

Lo que NO sabemos todavíaLo que NO sabemos todavía

Mantener el rigor técnico de la pieza 1 obliga a admitir lo que aún no está confirmado:

• ¿Quién es el LSP por defecto del SDK Liquid en Primal? Boltz aparece mencionado en la documentación pública de Breez; falta confirmación para el caso específico de Primal.
• ¿Cómo se respaldan los fondos LN? El SDK Liquid usa swaps en lugar de canales tradicionales, así que la pregunta cambia un poco, pero un usuario merece saber exactamente qué pasa con sus sats si pierde el dispositivo.

Estas siguen siendo preguntas abiertas. El hecho de que Breez SDK esté en el motor ya es un avance, pero la documentación pública de Primal sobre la implementación concreta sigue siendo escasa al cierre de esta pieza (2026-04-28).

Qué sigue en la serieQué sigue en la serie

Esta integración no solo cambia el onboarding personal. Abre una rama nueva: si Primal usa Breez SDK del lado wallet, los comercios pueden usar Breez (o alternativas equivalentes) del lado caja. Mismo motor Lightning en ambos extremos del pago.

La pieza 4 va a explorar esa rama: Breez vs Blink vs BTCPay Server — cómo elegir el procesador de pagos correcto para un comercio. Si tienes un local que ya acepta o quiere aceptar Bitcoin, ese es el episodio que te interesa.

Y la pieza 5, según cómo evolucione esto, será el caso de estudio: un comercio paraguayo aceptando sats con Breez, entrenado por la misma comunidad BPT.

CierreCierre

Marzo de 2026 dejó una línea entre comillas en unas release notes. Abril de 2026 le puso nombre: Breez SDK.

Para quien entra a Bitcoin vía Nostr, esto significa una sola cosa importante: Primal ya no es solo una app social con una wallet de propinas, es una puerta de entrada real a Lightning auto-custodiada. Con todo lo que eso implica: responsabilidad, fees y aprendizaje continuo.

Yo voy a seguir documentando públicamente lo que descubra. La pieza 4 viene pronto y va a ser la más comercial de la serie.

Si te sirvió: zap, follow en Nostr, comentario aquí en Stacker. Si encuentras un error técnico: corrígeme públicamente, lo agradezco más que el zap.