Logótipo oficial do MASTR MASTR
Menu

Bitcoin: recuperação e 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.

Atualizado em 30 de setembro de 2026 · MASTR Labs

Os artigos e gráficos técnicos estão em inglês. A navegação está disponível em 7 idiomas.

Guias de referência
  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. Exemplo concreto
  6. Fontes e originais

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 em tamanho completo. Credits ↗ Simplified example: incoming capacity starts on the peer’s side.

Exemplo 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.

Fontes e originais

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

Continuar a leitura

Bitcoin: recuperação e Lightning →

MASTR

Apoiar a investigação independente

As investigações, as provas originais e os guias são de acesso livre. Os donativos voluntários ajudam a financiar a investigação e a manter disponíveis as ferramentas MASTR.

Abrir carteira