Skip to content

Guidance for adopting "bitcoin" as a base unit (BIP 177) in applications #1168

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
yashrajd opened this issue May 27, 2025 · 2 comments · May be fixed by #1171
Open

Guidance for adopting "bitcoin" as a base unit (BIP 177) in applications #1168

yashrajd opened this issue May 27, 2025 · 2 comments · May be fixed by #1171
Assignees

Comments

@yashrajd
Copy link
Contributor

There has been lots of discussion & controversy on social media as well as Bitcoin Design Community discord regarding BIP 177 which proposes renaming the base unit (often referred to as 'satoshi' or sats) to bitcoin.

the discord conversation itself has useful references & insights that can be captured in a page that advises projects to adopt this new convention in their applications.

This topic is controversial is some circles, and important challenge for the Guide might be threading the needle being advise, advocacy and partisanship

Additional context

Topics to cover might include:

  • rationale
  • how to explain change to users
  • adopting a default and/or give users choice
  • how to help users avoid confusion (e.g. showing fiat amount beside ₿ amount)
  • a standardised ₿ symbol
  • how to refer to or display original bitcoin (100M base units)

Feel free to make content suggestions or suggest corrections or list other important things to be mentioned.

Content guidelines
If you're a contributor looking to tackle the issue, you can preview our content guidelines.

@matbalez
Copy link

I will put my hand up, feel free to assign ticket to me.

I will take a stab at making a Design Guide page summarizing the rationale and design implications for those wallet builders out there that are interesting in adopting BIP-177. I think it will be useful to have a reference point for those builders, as we are already seeing some wallets adopt this convention (Boardwalk Cash, Bitkit, and some early indications that CashApp & Square will do this as well).

@GBKS
Copy link
Contributor

GBKS commented Jun 2, 2025

As I just mentioned on Discord, a simple starting point could be an addition to the Units & Symbols page, which is one of the most visited pages in the guide. The page header image basically already looks the part. There's a paragraph on the Satcomma standard already, which also an effort to make units easier to read and work with.

A small addition can be made pretty quickly and be built upon as adoption happens (or doesn't happen).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
3 participants