Logo Oficial MASTR MASTR
Menú

Bitcoin: recuperación y Lightning

Lightning inbound liquidity: why a funded wallet may still fail to receive

Receiving capacity depends on the direction of channel balances and the available route.

Actualizado el 30 de septiembre de 2026 · MASTR Labs

Los artículos y gráficos técnicos están en inglés. La navegación está disponible en 7 idiomas.

Guías de referencia
  1. A channel has two sides
  2. A route is a chain of constraints
  3. Liquidity services add another relationship
  4. How to describe a failed receipt
  5. Ejemplo concreto
  6. Fuentes y originales

A channel has two sides

A Lightning channel allocates a shared funding output between its participants. Sending moves value towards the peer’s side; receiving needs value that can move towards yours. A channel can therefore have substantial total capacity and very little inbound capacity for its owner. Wallet balance and ability to receive are different questions. 1

A route is a chain of constraints

For a routed payment, each participating hop needs usable liquidity in the right direction, subject to channel policies and other limits. Your final hop can have enough inbound liquidity while an earlier hop cannot forward the chosen amount. Conversely, funding a new channel primarily from your own side often gives you outbound capacity rather than immediately creating equal receiving capacity. The exact usable amounts also reflect reserves and pending payments.

Liquidity services add another relationship

A wallet may arrange inbound capacity through a liquidity service, channel-opening mechanism or swap. This can improve usability but adds fees, availability dependencies and sometimes a different custody model. Inspect who controls the keys and what happens if the service is offline. The word ‘Lightning’ alone does not tell you whether the displayed balance is held in your own channel or credited by a custodian. 2

How to describe a failed receipt

Record the invoice amount, expiry and wallet’s reported failure rather than concluding that the network has no funds. Channels can be temporarily constrained by pending HTLCs or route selection. A retry may succeed under different conditions, but repeatedly opening channels without understanding balance direction can spend on-chain fees without solving the intended receiving problem.

Capacity has a direction
Diagrama explicativo. Abrir a tamaño completo. Credits ↗ Simplified example: incoming capacity starts on the peer’s side.

Ejemplo concreto

Ignore reserves and fees for this simplified example. A 1,000,000-sat channel allocates 900,000 sats locally and 100,000 to the peer. It can support much more outgoing than incoming value through that channel. Total capacity of 1,000,000 sats does not mean either direction can carry that full amount.

Fuentes y originales

  1. Lightning Labs: managing liquidity
  2. BOLT 2: channel management

Seguir leyendo

Bitcoin: recuperación y Lightning →

MASTR

Apoya la investigación independiente

Las investigaciones, las pruebas originales y las guías son de acceso libre. Las donaciones voluntarias ayudan a financiar la investigación y a mantener disponibles las herramientas de MASTR.

Abrir billetera