Référence des bits de fonctionnalités Lightning BOLT 9

Avant que deux nœuds Lightning ne transigent, ils comparent ce que chacun sait faire — anchors, paiements multi-parties, splicing, chemins masqués — au moyen d’un vecteur compact de bits de fonctionnalités défini par le BOLT 9. Un bit de travers, et la connexion ou le paiement échoue tout simplement. Cette référence liste chaque bit assigné avec son nom, les contextes où il apparaît, ses dépendances, et la règle paire/impaire « optionnel vs obligatoire » qui les régit. Elle complète notre ensemble Lightning aux côtés de l’index des BOLT et de la référence des factures BOLT11. Les descriptions sont conservées en anglais.

Réponse rapide

Les nœuds Lightning s'annoncent leurs capacités au moyen d'un vecteur de bits de fonctionnalités (feature bits), défini par le BOLT 9. Les bits vont par paires paire/impaire : le bit impair signale « je supporte cette fonctionnalité (optionnel) », le bit pair signale « je l'exige (obligatoire) » — la règle « it's ok to be odd » qui permet d'introduire une fonctionnalité en douceur avant de la rendre obligatoire. Cette référence liste les 24 bits assignés avec leur nom option_*, leur rôle, les contextes où ils apparaissent (init, node_announcement, channel_announcement, facture BOLT11, channel_type, chemin masqué) et leurs dépendances. Cinq fonctionnalités si universelles que la spec les marque « ASSUMED » (implicites, non annoncées) sont affichées telles quelles. Les descriptions sont conservées en anglais.

La règle qui compte : si les deux bits d'une paire sont mis, la fonctionnalité est traitée comme OBLIGATOIRE. Les bits pairs inconnus font échouer la connexion/le paiement (le pair ne peut pas garantir une exigence qu'il ne comprend pas); les bits impairs inconnus sont ignorés. Pour une facture, les bits « 9 » priment sur ceux de node_announcement. CSV/JSON gratuits sous CC BY 4.0.

Télécharger le CSV Télécharger le JSON API REST →

Bits	Nom	Rôle	Contextes	Dépend de
0/1	`option_data_loss_protect`	ASSUMÉ implicite dans tous les nœuds modernes	—	—
4/5	`option_upfront_shutdown_script`	Commits to a shutdown scriptpubkey when opening a channel	IN	—
6/7	`gossip_queries`	Peer has useful gossip to share	—	—
8/9	`var_onion_optin`	ASSUMÉ implicite dans tous les nœuds modernes	—	—
10/11	`gossip_queries_ex`	Gossip queries can include additional information	IN	—
12/13	`option_static_remotekey`	ASSUMÉ implicite dans tous les nœuds modernes	—	—
14/15	`payment_secret`	ASSUMÉ implicite dans tous les nœuds modernes	—	—
16/17	`basic_mpp`	Node can receive basic multi-part payments	IN9	`payment_secret`
18/19	`option_support_large_channel`	Can create large channels	IN	—
22/23	`option_anchors`	Anchor commitment type with zero-fee HTLC transactions	INT	—
24/25	`option_route_blinding`	Node supports blinded paths	IN9	—
26/27	`option_shutdown_anysegwit`	Future segwit versions allowed in shutdown	IN	—
28/29	`option_dual_fund`	Use v2 of channel open, enables dual funding	IN	—
34/35	`option_quiesce`	Support for the stfu (quiescence) message	IN	—
36/37	`option_attribution_data`	Can generate/relay attribution data in update_fail_htlc and update_fulfill_htlc	IN9	—
38/39	`option_onion_messages`	Can forward onion messages	IN	—
40/41	`zero_fee_commitments`	Zero-fee commitment and HTLC transactions	IN	`option_channel_type`
42/43	`option_provide_storage`	Can store other nodes' encrypted backup data	IN	—
44/45	`option_channel_type`	ASSUMÉ implicite dans tous les nœuds modernes	—	—
46/47	`option_scid_alias`	Supply channel aliases for routing	INT	—
48/49	`option_payment_metadata`	Payment metadata in a tlv record	9	—
50/51	`option_zeroconf`	Understands zeroconf channel types	INT	`option_scid_alias`
60/61	`option_simple_close`	Simplified closing negotiation	IN	`option_shutdown_anysegwit`
62/63	`option_splice`	Allows replacing the funding transaction with a new one	IN	—

Légende des contextes

I Presented in the init message.

N Presented in node_announcement messages.

C Presented in the channel_announcement message.

C- Presented in channel_announcement, but always odd (optional).

C+ Presented in channel_announcement, but always even (required).

9 Presented in BOLT11 invoices.

B Presented in the allowed_features field of a blinded path.

T Used in the channel_type field when opening channels.

Source : le BOLT 9 canonique de lightning/bolts (09-features.md, consulté le 2026-07-26). Se combine avec la référence des BOLT Lightning et la référence des factures BOLT11 (où les bits de contexte « 9 » apparaissent).

Produits, réparations et guides connexes

Dernière révision: 26 juillet 2026.