Skip to content

BIP172: Define Bitcoin Subunits as Satoshis#1841

Merged
murchandamus merged 1 commit intobitcoin:masterfrom
0ceanSlim:bip-satoshi-standard
May 8, 2025
Merged

BIP172: Define Bitcoin Subunits as Satoshis#1841
murchandamus merged 1 commit intobitcoin:masterfrom
0ceanSlim:bip-satoshi-standard

Conversation

@0ceanSlim
Copy link
Contributor

Formally define the smallest subunit of a bitcoin as a "Satoshi"

Copy link
Member

@murchandamus murchandamus left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @0ceanSlim for your proposal. I don’t think I saw discussion about this on the mailing list, did you post it there? This looks fairly complete already, I just have a few formatting suggestions. Note that the "Created" header in the preamble refers to the date that a proposal was assigned a number, so the current value should be "?".

@0ceanSlim
Copy link
Contributor Author

@murchandamus I actually have a draft email written as I knew it was procedure but didn't have the right email on hand. If you could send me the right one I'll send it.

@0ceanSlim
Copy link
Contributor Author

I've addressed your feedback! Thank you for taking a look!

@murchandamus
Copy link
Member

You can find information on the BIP Process in BIP 2. The email address is [email protected].

@0ceanSlim
Copy link
Contributor Author

0ceanSlim commented Apr 28, 2025

You can find information on the BIP Process in BIP 2. The email address is [email protected].

hm... That's the email I sent to but I got a response back that it didn't go through from gmx... I'll try sending again.

Perhaps it's because I'm not a part of the group and I don't know how to add my gmx to the group yet. I'll look into it.

Copy link
Member

@murchandamus murchandamus left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the quick turnaround. Could you take another look at the formatting of the alternative approaches? Were those intended to be lists or whole sentences? Right now it feels like it’s a bit in between those.

@0ceanSlim
Copy link
Contributor Author

awesome, committed changes. I think the email went out too. I added my gmx to the group and sent again and I didn't get a failure notice.

@0ceanSlim
Copy link
Contributor Author

0ceanSlim commented Apr 28, 2025

oh missed your first comment. It's meant to be a list but each reason is a sentence. How would you suggest I format?

Copy link
Member

@murchandamus murchandamus left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see, how about:

@0ceanSlim
Copy link
Contributor Author

I also added a section on how it's analogous to the traditional currency systems today in the rationale

Copy link

@edilmedeiros edilmedeiros left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe this will be out of scope for this proposal, but feels so related that I can't not mention it.

Unicode has standardised a Bitcoin symbol under code U+20BF: ₿

Plane 0: Basic Multilingual Plane
Unicode Block: Currency Symbols
Unicode Version: 16.0

Would be at least nice to have it mentioned since you are formally defining 1 bitcoin in term of satoshis.

Unfortunately, they didn't define a symbol for satoshis. Maybe this proposal helps to justify doing so in the future, even though I believe we don't have such a common currency symbol for satoshis.

@murchandamus
Copy link
Member

murchandamus commented Apr 29, 2025

Maybe this proposal helps to justify doing so in the future, even though I believe we don't have such a common currency symbol for satoshis.

While I have proposed a couple symbols myself in the past, I would like to second that it should probably remain out of scope for this proposal, as debates about a satoshi symbol tend to consume other topics and not converge.

Copy link
Contributor

@cryptoquick cryptoquick left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Finally, a sensible BIP. I appreciate how you addressed Murch's feedback. You have my ACK.

@0ceanSlim
Copy link
Contributor Author

I'm good with it now. Just waiting on more review and feedback! Thanks for all the comments so far.

Copy link
Contributor Author

@0ceanSlim 0ceanSlim left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've addressed all current feedback and made some minor changes.

@murchandamus murchandamus changed the title Add BIP: Define Bitcoin Subunits as Satoshis BIP172: Define Bitcoin Subunits as Satoshis May 1, 2025
Copy link
Member

@murchandamus murchandamus left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I appreciate the high responsiveness. Let’s call this BIP 172.

Could you please add an entry in the README table and update the BIP number, Comments-URI, and Created headers as well as the file name?

@0ceanSlim
Copy link
Contributor Author

Actually before proceeding I want to address this comment on the mailing list

From Lucas André:

Maranatha!

I propose a small addition that could improve this, particularly for users relying on assistive technologies (like our boi Hal Finney once did).

Specifically, I suggest adding a short section on accessibility and voice/UI guidance. Your proposal does a solid job, but it doesn't yet cover how these should be handled in screen readers, voice assistants, or accessible interfaces. Below is a proposed section that could be added under "specification" or introduced as a new non-normative section.

To ensure clarity and inclusiveness in UIs and assistive technologies, the following recommendations apply:

Pronunciation:
The abbreviation "sat" should be pronounced as /sæt/, and "sats" (plural) should be pronounced as /sæts/ (rhyming with "cats") by screen readers and voice assistants. "Satoshi" (singular) is pronounced /səˈtoʊʃi/. "Satoshis" (plural) is pronounced /səˈtoʊʃiz/.

Singular vs. Plural:
"1 sat" should be read as "one satoshi" and "100 sats" as "one hundred satoshis" to preserve correct pluralization and meaning. When reading aloud:

"1 sat" → "one satoshi" → /wʌn səˈtoʊʃi/
"100 sats" → "one hundred satoshis" → /wʌn ˈhʌndrəd səˈtoʊʃiz/

Readable Formats:
Prefer full terms in accessibility modes (e.g., "satoshis" instead of "sats"), and group digits to assist parsing (e.g., "12,345" instead of "12345").

Contextual Labels:
Interfaces should use clear alt-text or aria-labels such as: alt="Transaction fee: 14 satoshis per virtual byte". This enables screen readers and other assistive technologies to accurately interpret and communicate the content.

If this makes sense, I'd be happy to help refine it or adjust to fit the structure if necessary.

References:
https://www.internationalphoneticalphabet.org/
https://tophonetics.com/

Peace,
Lucas.

Link to mailing list comment

While this is a great suggestion I'm on the fence as to whether or not this makes the BIP too verbose. Please let me know your thoughts. Sorry I'm addressing this comment last minute!

@murchandamus
Copy link
Member

While this is a great suggestion I'm on the fence as to whether or not this makes the BIP too verbose. Please let me know your thoughts. Sorry I'm addressing this comment last minute!

I don’t think this is too verbose, feel free to put it in.

@0ceanSlim
Copy link
Contributor Author

I'm sorry about all the bad commits... I can't seem to get the readme correct.

Also, @murchandamus if you'd like to suggest how I should format the addition of information for users with assistive technologies, that would be great

@0ceanSlim
Copy link
Contributor Author

Alright Everyone. Take a look see! I've added Accessibility Considerations and fixed some small punctuation errors ht/ @macedogm

Copy link

@macedogm macedogm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ACK (in case it counts)

@edilmedeiros
Copy link

I would not oppose merging as it is, but I don't think the assistive tech additions contribute to the proposal. They are quite general comments/recommendations that apply to the good design of all human interfaces, not only bitcoin-related. Although important, they dilute the main contribution which is formally defining bitcoin subunits.

Sorry I didn't seem this earlier, the pace of change in this proposal is quite swifty.

@0ceanSlim
Copy link
Contributor Author

0ceanSlim commented May 5, 2025

@edilmedeiros I shared this concern but asked earlier and @murchandamus said he didn't think it was too verbose and to go ahead and add it if I would like to. So I did. I'd love to see this merged ❤️

@katesalazar
Copy link
Contributor

katesalazar commented May 5, 2025

a very nit but some sections have a space line between the heading and the content while others do not

@0ceanSlim
Copy link
Contributor Author

a very nit but some sections have a space line between the heading and the content while others do not

Good catch. I added a space line after each heading. It seemed other BIPs mostly have it this way.

@0ceanSlim
Copy link
Contributor Author

Regardless of any pending changes, I would kindly ask for this to be merged in it's current form as we are indeed starting to get very nit on suggestions. That is of course unless any reviewers have a big pending issue with it's current form.

@murchandamus
Copy link
Member

Sorry, the unrelated on-going community debate has taken a big chunk of my time in the past week. Another review of this proposal is on my todo list but may take another few days.

Copy link
Member

@murchandamus murchandamus left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have no further review comments. LGTM

@murchandamus murchandamus force-pushed the bip-satoshi-standard branch from 269746e to c379271 Compare May 8, 2025 17:26
@murchandamus murchandamus merged commit bce061f into bitcoin:master May 8, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants