BSVAlias is a set of standards assembled to make it simple for individual domains to incorporate wallet services. These services can be run by the domain or through a third party.

The goals of BSVAlias are:

  • User friendly payments
  • Permissionless implementation
  • Self hosting
  • Automatic discovery process
  • PKI infrastructure (IPV4)
  • Security
  • Extensibility

Paymail leverages BSVAlias into a set of protocols that allows BSV wallets to receive payments using email addresses as handles.

The protocols allow for flexibility in capabilities and implementation.

Service Discovery

The Service Discovery Process is split into two phases:

  1. Host Discovery
  2. Capability Discovery

Host Discovery

Host Discovery is a DNS based lookup of the responsible host for a given BSVAlias. The only practical implementation that exists today is Paymail, in which the host is identified through the domain attached to the receiving party’s paymail address which is in standard email format (e.g. user@domain.tld).

BSVAlias can be:

  1. Self hosted
  2. Hosted using 3rd party providers (done using a DNS SRV record)

This makes BSVAlias compatible with the internet infrastructure we have today

Capability Discovery

Once the host has been identified, the sending party must learn its supported features

This is in the format of a machine readable (JSON) document which is placed on the host web server in the .well-known folder:


Capabilities of a host are not necessarily reflected in an individual account.


Bitcoin Wiki


paymail is a collection of protocols for Bitcoin SV wallets that allow for a set of simplified user experiences to be delivered across all wallets in the ecosystem.

❌ No more complicated 17Dx2iAnGWPJCdqVvRFr45vL9YvT86TDsn addresses

✅ Simple payment handles like <alias>@<domain>.<tld>

The goals of the paymail protocol are:

  • User friendly payment destinations through memorable handles
  • Permissionless implementation
  • Self-hosted or delegated to a managed service
  • Automatic service discovery/location
  • PKI infrastructure
  • Cross-wallet exchange of single-use transaction output scripts of any construction
  • Request and response authentication
  • Security and policy management
  • Capability extensibility and discovery


The family of related protocols are collectively referred to as the bsvalias protocols. At the time of writing, these include:


paymail is the name for the implementation of the following protocols:

The paymail brand is reserved for products and services that, at a minimum, implement each of the above.

Extension Protocols

As defined in the BRFC Specifications, anybody can propose an extension to the bsvalias and paymail protocols, and as per the Capability Discovery section of the Service Discovery protocol, implementations can declare support for extensions to allow for cross-wallet processes.

Extension protocols are the collection of protocols not contained within the core paymail set defined above, but that are fully compatible with bsvalias protocols and paymail implementations. Notable examples presently include:

Copyright 2019 nChain and Money Button

« Back to Glossary Index

Written by Ramon Quesada

Passionate about Blockchain & Bitcoin technology since 2013, Co- Founder of, Team Manager in the CoinTelegraph Spain franchise (2016-2017 years) Co. Organizer of the Blockchain Boot camp Valencia 2018, Co. Organizer of the mini Hackathon BitcoinSV Barcelona, in August 2019, current coordinator of the BSV Valencia Meetup.

Attacks on Bitcoin – 51% Attack

Base58Check encoding