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:

Host Discovery
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:

Self hosted
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:

https://<target>:<port>/.well-known/bsvalias

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

https://wiki.bitcoinsv.io/index.php/BSVAlias

Overview

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

bsvalias

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

paymail

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

Service Discovery
Public Key Infrastructure
Basic Address Resolution from the Payment Addressing protocol group

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: