CLN Liquidity Ads: Fix Lease Request and Rate Errors

What Are CLN Liquidity Ads?

CLN Liquidity Ads (RFC 878) allow nodes to advertise inbound liquidity for sale. When enabled, your node broadcasts a liquidity ad rate in its gossip messages, letting other nodes purchase inbound capacity from you during channel opens.

Common Errors and Fixes

1. liquidity_ads not supported by peer

The remote node does not support Liquidity Ads. Only CLN nodes with the feature enabled will respond.

lightning-cli listnodes <peer_id> | grep -i liquidity
# If empty, peer does not support it

2. lease_request failed: rate too low

You are requesting liquidity at a rate below what the provider advertises. Check their current rate first.

lightning-cli listnodes <provider_id> | jq '.nodes[0].option_will_fund'
# Adjust your offer to meet or exceed their minimum

3. channel too small for lease

The leased amount exceeds channel capacity minus reserve. Channel size must be at least lease amount plus 1% reserve.

# For 1M sat lease, open at least 1,010,000 sat channel
lightning-cli fundchannel <peer_id> 1100000 --request_amt 1000000 --compact_lease <hex>

4. compact_lease mismatch

# Fetch valid lease hex from provider gossip
lightning-cli listnodes <provider_id> | jq -r '.nodes[0].option_will_fund.compact_lease'

5. Liquidity Ads not enabled

# Add to ~/.lightning/config
liquidity-ads=yes
fee-base=2000
fee-per-satoshi=1
cltv-expiry-delta=80
# Restart CLN after changes

Verify Your Setup

# Confirm broadcast
lightning-cli getnodeinfo | jq '.our_node.option_will_fund'

# Check active leases
lightning-cli listpeerchannels | jq '.channels[] | select(.funding.leased == true)'