Eclair Bolt12 Errors: Fix BOLT12 Offer and Invoice Request Failures

Eclair BOLT12 errors occur during offer creation or invoice request negotiation. This guide covers the most common failures.

Common Errors

offer_not_found: Offer expired or removed. path_not_found: Blinded path unavailable. invoice_request_rejected: Recipient node rejected the request.

Enable BOLT12 in eclair.conf

eclair.features.option_route_blinding = optional
eclair.features.basic_mpp = optional

Create and Pay Offers

# Create
./eclair-cli createoffer --amount=1000msat --description="Test"

# Pay
./eclair-cli payoffer --offer=<bolt12_offer> --amount=1000msat

Fallback to BOLT11

BOLT12 is experimental. For production, fall back to BOLT11 invoices when path_not_found occurs. Ensure both nodes support option_route_blinding before using BOLT12.