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 · 1 comment
Open

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).

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

No branches or pull requests

2 participants