public inbox for bitcoindev@googlegroups.com
 help / color / mirror / Atom feed
From: Matt Corallo <lf-lists@mattcorallo.com>
To: bitcoindev@googlegroups.com
Subject: [bitcoindev] Mapping Human-Readable Names to Payment Instructions
Date: Tue, 13 Feb 2024 11:56:38 -0800	[thread overview]
Message-ID: <34eaef2a-b53f-4622-a620-a3bc5161cbf7@mattcorallo.com> (raw)
In-Reply-To: <3452d0b7-2d46-46bd-a59d-5b1206d882d0@mattcorallo.com>


Hey new-list!

I'd like to propose a BIP defining a mechanism to resolve human-readable names to Bitcoin payment 
instructions in a way that supports lightning/on-chain/payjoin/silent addresses/etc/etc. Below you 
can find the full BIP draft for comments, as well as in the BIPs repo at 
https://github.com/bitcoin/bips/pull/1551

Matt



==Abstract==
This BIP proposes a standard format for encoding [[bip-0021.mediawiki|BIP 21]] URI schemes in DNS 
TXT records.

==Motivation==
Various Bitcoin and other cryptocurrency applications have developed human-readable names for 
payment instructions over time, with marketplace adoption signaling strong demand for it from users.

The DNS provides a standard, global, hierarchical namespace mapping human-readable labels to records 
of various forms. Using DNSSEC, the DNS provides cryptographic guarantees using a straightforward 
PKI which follows the hierarchical nature of the DNS, allowing for stateless and even offline 
validation of DNS records from a single trusted root.

Further, because DNS queries are generally proxied through ISP-provided or other resolvers, DNS 
queries usually do not directly expose the queryer's IP address. Further, because of the prevalence 
of open resolvers, the simplicity of the protocol, and broad availability of DNS recursive resolver 
implementations, finding a proxy for DNS records is trivial.

Thus, using TXT records to store Bitcoin payment instructions allows for human-readable Bitcoin 
payment destinations which can be trivially verified on hardware wallets and which can be resolved 
relatively privately.

==Specification==

=== General rules for handling ===
Bitcoin wallets MUST NOT prefer to use DNS-based resolving when methods with explicit public keys 
are available. In other words, if a standard Bitcoin address or direct BIP 21 URI is available or 
would suffice, Bitcoin wallets MUST prefer to use that instead.

=== Records ===
Payment instructions are indexed by both a user and a domain. Instructions for a given `user` and 
`domain` are stored at `user`.user._bitcoin-payment.`domain` in a single TXT record.

All payment instructions MUST be DNSSEC-signed.

Payment instructions MAY resolve through CNAME or DNAME records as long as all such records and the 
ultimate records pointed to by them are DNSSEC signed.

User and domain names which are not expressible using standard printable ASCII MUST be encoded using 
the punycode IDN encoding defined in [[https://datatracker.ietf.org/doc/html/rfc3492|RFC 3492]] and 
[[https://datatracker.ietf.org/doc/html/rfc5891|RFC 5891]].

=== Resolution ===

Clients resolving Bitcoin payment instructions MUST ignore any TXT records at the same label which 
do not begin with (ignoring case) "bitcoin:". Resolvers encountering multiple "bitcoin:"-matching 
TXT records at the same label MUST treat the records as invalid and refuse to use any payment 
instructions therein.

Clients resolving Bitcoin payment instructions MUST fully validate DNSSEC signatures leading to the 
DNS root (including any relevant CNAME or DNAME records) and MUST NOT accept DNSSEC signatures which 
use SHA-1 or RSA with keys shorter than 1024 bits. Resolvers MAY accept SHA-1 DS records.

Clients resolving Bitcoin payment instructions MUST NOT trust a remote resolver to validate DNSSEC 
records on their behalf.

Clients resolving Bitcoin payment instructions MUST support resolving through CNAME or DNAME records.

Resolvers MAY support resolving non-ASCII user and domain identifiers. Resolvers which do support 
non-ASCII user and domain identifiers MUST take precautions to prevent homograph attacks and SHOULD 
consider denying paste functionality when entering non-ASCII identifiers.

=== Address Reuse ===

Payment instructions with on-chain addresses which will be re-used SHOULD be rotated as regularly as 
possible to reduce address reuse. Such payment instructions SHOULD also use a relatively short DNS 
TTL to ensure regular rotation takes effect quickly. In cases where this is not practical, payment 
instructions SHOULD NOT contain on-chain addresses (i.e. the URI path SHOULD be empty).

=== Display ===

Wallets SHOULD parse recipient information in the form `user`@`domain` and resolve such entry into 
recipient information using the above record. Similarly, wallets accepting payment information from 
external devices (e.g. hardware wallets) SHOULD accept RFC 9102-formatted proofs (as a series of 
unsorted `AuthenticationChain` records) and, if they verify, SHOULD display the recipient in the 
form `user`@`domain`.

== Rationale ==

There are many existing schemes to resolve human-readable names to cryptocurrency payment 
instructions. Sadly, these current schemes suffer from a myriad of drawbacks, including (a) lacking 
succinct proofs of namespace to public key mappings, (b) revealing sender IP addresses to recipients 
or other intermediaries as a side-effect of payment, (c) relying on the bloated TLS Certificate 
Authority infrastructure, or (d) lacking open access, not allowing anyone to create a namespace mapping.

=== DNS Rather than blockchain-based solutions ===
There are many blockchain-based alternatives to the DNS which feature better censorship-resistance 
and, in many cases, security. However, here we chose to use the standard ICANN-managed DNS namespace 
as many blockchain-based schemes suffer from (a), above (though in some cases this could be 
addressed with cryptographic SNARK schemes). Further, because they do not have simple client-side 
querying ability, many of these schemes use trusted intermediaries which resolve names on behalf of 
clients. This reintroduces drawbacks (b) and often (c) as well.

Finally, its worth noting that none of the blockchain-based alternatives to the DNS have had 
material adoption outside of their specific silos, and committing Bitcoin wallets to rely on a 
separate system which doesn't see broad adoption may not be sustainable.

=== DNS Rather than HTTP-based solutions ===
HTTP(s)-based payment instruction resolution protocols suffer from drawbacks (a), (b), and (c), 
above, and generally shouldn't be considered a serious alternative for payment instruction resolution.

=== Private DNS Querying ===
While public recursive DNS resolvers are very common (e.g. 1.1.1.1, 8.8.8.8, and 9.9.9.9), using 
such resolvers directly (even after validating DNSSEC signatures) introduces drawback (b), at least 
in regard to a centralized intermediary. Resolving payment instructions recursively locally would 
instead introduce drawback (b) directly to the recipient, which may well be worse.

For payers not using VPN or other proxying technologies, they generally trust their ISP for 
protection against denial of service anyway, so using ISP-provided recursive DNS resolvers is 
sufficient.

However, for the best privacy, payers are encouraged to perform DNS resolution over Tor or another 
VPN technology.

Lightning payers should consider utilizing DNS resolution over native onion messages, using the 
protocol described in [[BLIP 32|https://github.com/lightning/blips/blob/master/blip-0032.md]]

=== DNS Enumeration ===

In most cases where payments are accepted from any third-party, user enumeration is practical by 
simply attempting to send small value payments to a list of possible user names. However, storing 
all valid users in the DNS directly may make such enumeration marginally more practical. Thus, those 
wishing to avoid such enumeration should carefully ensure all DNS names return valid payment 
instructions. Note when doing so that wildcard records are identified as such by the DNSSEC RRSIG 
labels counter and are differentiable from non-wildcard records.

== Examples ==

`matt@mattcorallo.com` resolves to
`matt.user._bitcoin-payment.mattcorallo.com. 3600 IN TXT 
"bitcoin:?b12=lno1qsgqmqvgm96frzdg8m0gc6nzeqffvzsqzrxqy32afmr3jn9ggkwg3egfwch2hy0l6jut6vfd8vpsc3h89l6u3dm4q2d6nuamav3w27xvdmv3lpgklhg7l5teypqz9l53hj7zvuaenh34xqsz2sa967yzqkylfu9xtcd5ymcmfp32h083e805y7jfd236w9afhavqqvl8uyma7x77yun4ehe9pnhu2gekjguexmxpqjcr2j822xr7q34p078gzslf9wpwz5y57alxu99s0z2ql0kfqvwhzycqq45ehh58xnfpuek80hw6spvwrvttjrrq9pphh0dpydh06qqspp5uq4gpyt6n9mwexde44qv7lstzzq60nr40ff38u27un6y53aypmx0p4qruk2tf9mjwqlhxak4znvna5y"`
Note that `b12` indicates a value containing a lightning BOLT12 offer.

== Reference Implementations ==
* A DNSSEC proof generation and validation implementation can be found at 
https://git.bitcoin.ninja/index.cgi?p=dnssec-prover;a=summary
* A lightning-specific name to payment instruction resolver can be found at 
https://git.bitcoin.ninja/index.cgi?p=lightning-resolver;a=summary
* Reference implementations for parsing the URI contents can be found in [[bip-0021.mediawiki|BIP 21]].

-- 
You received this message because you are subscribed to the Google Groups "Bitcoin Development Mailing List" group.
To unsubscribe from this group and stop receiving emails from it, send an email to bitcoindev+unsubscribe@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/bitcoindev/34eaef2a-b53f-4622-a620-a3bc5161cbf7%40mattcorallo.com.


           reply	other threads:[~2024-02-13 21:12 UTC|newest]

Thread overview: expand[flat|nested]  mbox.gz  Atom feed
 [parent not found: <3452d0b7-2d46-46bd-a59d-5b1206d882d0@mattcorallo.com>]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=34eaef2a-b53f-4622-a620-a3bc5161cbf7@mattcorallo.com \
    --to=lf-lists@mattcorallo.com \
    --cc=bitcoindev@googlegroups.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox