Skip to content

Add content around using names in lightning apps #853

Closed

Description

@Bosch-0

Bitcoin lightning applications, much like traditional and neo banking apps, should leverage the use of names. Names are useful in personalization of apps. For example adding a welcoming message like Welcome back, bosch when you log into the app. They can also be used for sending and receiving payments, and bitcoin already has technology we can use to leverage this common UX practice, see below.

Using NameDesc

NameDesc allows a user to attach a name to a generated invoice so senders know who they are paying.

When inputting a name during onbaording it can be used in two ways:

  1. A NameDesc which gets attached to any generated invoices
  2. A way to personalize content with in the app, such as with a welcome back message.

Using Lightning addresses

Lightning addresses are an invoice protocol that let users create more human readable ways to send and receive lightning payments, such as bosch@bitcoin.app.

Ideally you'd have users set their lightning address during onboarding. Where this can be interesting is that this one input, such as my name bosch, can be used in several unique ways:

  1. The generation of a standard lightning address such as bosch@bitcoin.app that can be used to send and receive bitcoin with any lightning wallet that supports this standard
  2. The generation of a unique payment ID for payments between apps that use the same lightning address server. For example, users can send payments to just bosch instead of bosch@bitcoin.app as long as the payment destination is using the same lightning address domain @bitcoin.app. This would mean having a unique payment flow for this type of payment format, such as Pay with bitcoin.app payment ID option, but this is very common in modern banking apps and I don't think it would confuse people. What would happen behind the scenes is when bosch is entered it would ping the server, see if bosch@bitcoin.app exists, if it does the user can pay the other user. This could also be used in reverse to request a payment with the receiver generating and sending an invoice to sender over the server. So the user is paying or requesting bosch@bitcoin.app by just entering bosch.
  3. A piece of metadata for personalization of the app as mentioned above, such as a welcome back message.
  4. You could maybe also add NameDesc to this stack but lightning addresses are already pretty personalized.

https://zebedee.io/ already does this, its really good UX.

Using Offers

Offers are an invoice protocol that makes it easy to generate and send invoices through the lightning network. They use a vendor parameter, similar to NameDesc, to add a name to generated invoices.

When inputting a name during onbaording, the input can be used in two ways:

  1. As the vendor parameter that is used in any generated invoices
  2. A way to personalize content with in the app, such as with a welcome back message.

If the application uses all 3 of these technologies the name input could really be used for all of the use cases outlined above. This would be some good content to add to the First use section of the daily spending wallet or written up as a case study, thoughts?

Activity

  1. GBKS commented on Jun 16, 2022

    @GBKS
    Contributor

    This proposal is fully based on the wallet provider also offering lightning addresses to users. Is that something we want to push?

    Not sure I'd put usernames as the primary identifier for people. "electricPanda365" is much less useful in an invoice than "Christoph Ono". A feature based on real-world names like regular phone contacts and what is described in the contacts page seems more flexible. Zebedee is about gaming, and their gamer tags are offered as a service to costumers and can be integrated into other games, so I think that focus makes sense.

  2. added
    CopyTask is about improving text.
    Daily spending walletReferring to the Daily spending wallet reference design section.
    on Jun 16, 2022
  3. Bosch-0 commented on Jun 18, 2022

    @Bosch-0
    CollaboratorAuthor

    This proposal is fully based on the wallet provider also offering lightning addresses to users. Is that something we want to push?

    We already do, we suggest lightning addresses several times throughout this reference design.

    Instead of username we can just say name then to keep things generic

    "electricPanda365" is much less useful in an invoice

    That's subjective, maybe they want to be called electricPanda365? This is for the user to decide.

  4. changed the title [-]Add content around using usernames in lightning apps[/-] [+]Add content around using names in lightning apps[/+] on Jun 18, 2022
  5. GBKS commented on Jun 21, 2022

    @GBKS
    Contributor

    We already do, we suggest lightning addresses several times throughout this reference design.

    Supporting lightning addresses for payments is different than offering custom lightning addresses, no?

    By the way, is it possible to do this in a non-custodial way? With Zebedee, I have to create an account via email/password, and they also ask me to verify my ID.

    Instead of username we can just say name then to keep things generic

    Differentiating between "Display name" and "Username" (or handle) might be the way to go.

  6. pavlenex commented on Nov 22, 2022

    @pavlenex
    Contributor
  7. GBKS commented on Jan 13, 2025

    @GBKS
    Contributor

    Not just for lightning apps, but the idea of usernames is being discussed again in the context of human-readable addresses (BIP-353), in PR #1082.

    • User picks a unique username for the service, and the service sets up a managed email-like address that points to the payment information
    • Payments from one user of the service to another can be done by just entering the username (not the full address)

    Display names (like "Amanda Patel"), not usernames (like "amanda-patel") are a different story, and I think we have that covered well in the contacts page.

    Regarding NameDesc, I have not seen it discussed in a long time, anyone know if more wallets have implemented it? We have that also covered in the payment request formats page.


    I'll close this issue now, since it's not seen activity in over 2 years and I think we have the meat of it covered in these other pages and #1082.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    CopyTask is about improving text.Daily spending walletReferring to the Daily spending wallet reference design section.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions