Difference between revisions of "BIP 0179"

From Bitcoin Wiki
Jump to: navigation, search
(Update BIP text with latest version from https://github.com/bitcoin/bips/blob/0a388fac4619e440/bip-0179.mediawiki)
(Update BIP text with latest version from https://github.com/bitcoin/bips/blob/43da5dec5eaf0d81/bip-0179.mediawiki)
Line 6: Line 6:
   Title: Name for payment recipient identifiers
   Title: Name for payment recipient identifiers
   Author: Emil Engler <me@emilengler.com>
   Author: Emil Engler <me@emilengler.com>
          MarcoFalke <falke.marco@gmail.com>
           Luke Dashjr <luke+bip@dashjr.org>
           Luke Dashjr <luke+bip@dashjr.org>
   Comments-Summary: No comments yet.
   Comments-Summary: No comments yet.

Latest revision as of 12:06, 4 August 2022

This page describes a BIP (Bitcoin Improvement Proposal).
Please see BIP 2 for more information about BIPs and creating them. Please do not just create a wiki page.

Please do not modify this page. This is a mirror of the BIP from the source Git repository here.

  BIP: 179
  Title: Name for payment recipient identifiers
  Author: Emil Engler <me@emilengler.com>
          Luke Dashjr <luke+bip@dashjr.org>
  Comments-Summary: No comments yet.
  Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-0179
  Status: Draft
  Type: Informational
  Created: 2019-10-17
  License: CC0-1.0


This BIP proposes a new term for 'address'


The new term is: Bitcoin Invoice Address

The Bitcoin and Address parts are optional. The address suffix should only be used as a transitional step.

A Bitcoin Invoice Address is a string of characters that can be used to indicate the intended recipient and purpose of a transaction.


Bitcoin addresses are intended to be only used once and you should generate a new one for every new incoming payment. The term 'address' however indicates consistency because nearly everything on the internet or the offline world with the term 'address' is something that rarely or even never changes (postal address, email address, IP addresses (depends heavily on the provider), etc.) The motivation for this BIP is to change the term address to something that indicates that the address is connected to a single transaction.


The reason why we use Bitcoin Invoice Address or just Invoice is to emphasize that it is single-use. The terms Bitcoin and Address are optional for the following reasons: For Bitcoin:

  • Useful for multicoin wallets to indicate that it belongs to Bitcoin
  • Indicates a difference between a lightning and an on-chain invoice

For Address:

  • To not confuse users with a completely new term
  • To show that it is where you send something to
  • To not break backwards compatibility

This gives us the four following possibilities:

  • Bitcoin Invoice Address
  • Bitcoin Invoice
  • Invoice Address
  • Invoice

Backwards Compatibility

To avoid issues, the 'Address' suffix is permitted, but not recommended. The suffix 'Address' remains so users should be immediately able to recognize it until the new term is widely known.


Thanks to Chris Belcher for the suggestion of the term 'Bitcoin Invoice Address'


This BIP is released under CC0-1.0 and therefore Public Domain.