Skip to content

Commit 561ff77

Browse files
cron: update bips submodule and build
1 parent 8b512f9 commit 561ff77

430 files changed

Lines changed: 1637 additions & 346 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

web/content/172/index.md

Lines changed: 182 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,182 @@
1+
2+
+++
3+
title = "Define Bitcoin Subunits as Satoshis"
4+
date = 2025-05-01
5+
weight = 172
6+
7+
[taxonomies]
8+
authors = ["OceanSlim"]
9+
status = ["Draft"]
10+
11+
[extra]
12+
bip = 172
13+
status = ["Draft"]
14+
github = "https://github.com/bitcoin/bips/blob/master/bip-0172.mediawiki"
15+
note = "THIS FILE IS AUTOMATICALLY GENERATED - NOT MEANT FOR EDITING"
16+
+++
17+
18+
```
19+
BIP: 172
20+
Layer: Applications
21+
Title: Define Bitcoin Subunits as Satoshis
22+
Author: OceanSlim <oceanslim@gmx.com>
23+
Comments-Summary: No comments yet.
24+
Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-0172
25+
Status: Draft
26+
Type: Informational
27+
Created: 2025-05-01
28+
License: BSD-2-Clause
29+
```
30+
31+
<h2> Abstract </h2>
32+
33+
34+
This BIP proposes to formally define and standardize Bitcoin's smallest indivisible unit (1/100,000,000 of a bitcoin) as "satoshi" (singular) or "satoshis" (plural), with "sats" as the standard abbreviated form. This standardization aims to improve clarity in communication, user interfaces, documentation, and development across the Bitcoin ecosystem.
35+
36+
<h2> Motivation </h2>
37+
38+
39+
As Bitcoin adoption grows, the need for a clear, standardized terminology for its subunits becomes increasingly important. Currently, there are various terms used to refer to Bitcoin's smallest unit (1/100,000,000 BTC), including "satoshi", "satoshis", "sat", "sats" and sometimes simply expressed as decimal values of bitcoin (0.00000001 BTC).
40+
41+
This lack of standardization can lead to:
42+
43+
1. Confusion for newcomers to the Bitcoin ecosystem
44+
1. Inconsistent user experiences across different applications and services
45+
1. Ambiguity in technical documentation and discussions
46+
1. Potential errors in development and implementation of Bitcoin-related software
47+
48+
49+
By formally establishing "satoshi"/"satoshis" as the standard term with "sats" as the recognized abbreviation, we can improve clarity and consistency throughout the ecosystem.
50+
51+
<h2> Specification </h2>
52+
53+
54+
This BIP formally defines:
55+
56+
1. The term "satoshi" (singular) or "satoshis" (plural) shall be the standard term for 1/100,000,000 of a bitcoin (0.00000001 BTC).
57+
1. The abbreviation "sat" (singular) or "sats" (plural) shall be the standard short form for "satoshi"/"satoshis".
58+
1. The relationship between units shall be expressed as:
59+
* 1 bitcoin (BTC) = 100,000,000 satoshis
60+
* 1 satoshi = 0.00000001 bitcoin
61+
1. The terms "satoshi" and "sats" are not proper nouns when referring to the unit of currency and should not be capitalized except at the beginning of sentences or in titles.
62+
1. Bitcoin-related applications, services, documentation, and communications are encouraged to use these standardized terms to promote consistency across the ecosystem.
63+
64+
65+
<h2> Accessibility Considerations </h2>
66+
67+
68+
To ensure clarity and inclusiveness in user interfaces and assistive technologies, the following recommendations apply:
69+
70+
1. Pronunciation:
71+
* 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.
72+
* "Satoshi" (singular) is pronounced /səˈtoʊʃi/. "Satoshis" (plural) is pronounced /səˈtoʊʃiz/.
73+
74+
75+
1. Singular vs. Plural: Preserve correct pluralization when reading amounts:
76+
* "1 sat" should be read as "one satoshi" (/wʌn səˈtoʊʃi/)
77+
* "100 sats" should be read as "one hundred satoshis" (/wʌn ˈhʌndrəd səˈtoʊʃiz/)
78+
79+
80+
1. Readable Formats:
81+
* Prefer full terms in accessibility modes (e.g., "satoshis" instead of "sats")
82+
* Group digits to assist parsing (e.g., "12,345" instead of "12345")
83+
84+
85+
1. Contextual Labels:
86+
* Interfaces should use clear alt-text or aria-labels such as: alt="Transaction fee: 14 satoshis per virtual byte"
87+
* This enables screen readers and other assistive technologies to accurately interpret and communicate the content
88+
89+
90+
<h2> Rationale </h2>
91+
92+
93+
Satoshi Nakamoto, the creator of Bitcoin, established that one bitcoin would be divisible to eight decimal places, creating 100,000,000 units per bitcoin. The community has organically adopted the term "satoshi" to refer to this smallest unit.
94+
95+
As Bitcoin's value has increased, expressing smaller values in fractional bitcoins has become increasingly unwieldy (e.g., 0.00000546 BTC). Using satoshis as the unit of account for smaller values (e.g., 546 sats) is more intuitive and less error-prone for humans.
96+
97+
The term "satoshi" and its abbreviation "sats" have already gained widespread adoption within the Bitcoin community. This BIP seeks to formalize this existing convention rather than introduce new terminology.
98+
99+
<h3> Analogous to Traditional Currency Systems </h3>
100+
101+
102+
The proposed bitcoin/satoshi (or BTC/sat) standard follows the established pattern of major world currencies, which typically have a primary unit and a smaller subunit. Most notably, the United States dollar—the world's primary reserve currency—uses dollars and cents in a two-tier denomination system. This familiar dollars/cents model has proven effective and intuitive for everyday transactions across different scales.
103+
The bitcoin/satoshi system mirrors this approach while accounting for Bitcoin's higher divisibility requirements. Furthermore, the phonetic similarity between "sat" and "cent" creates an intuitive bridge for newcomers to understand Bitcoin's smallest unit, making the learning curve less steep for those familiar with traditional currency systems. This natural familiarity leverages existing mental models of how currency denominations work.
104+
105+
<h3> Comparison with Alternative Approaches </h3>
106+
107+
108+
Two notable proposals related to Bitcoin denomination have been put forward:
109+
110+
Our proposal represents a minimally disruptive approach to standardization, formalizing existing common practice rather than introducing new terms (BIP-176) or redefining existing ones (BIP-177).
111+
112+
<h4> BIP-176: Bits Denomination </h4>
113+
114+
115+
BIP-176 proposes using "bits" as a standard term for 100 satoshis (or 0.000001 BTC). While this proposal has merit for creating a middle-ground denomination that avoids small decimal places when bitcoin's value is high, our approach differs in that it:
116+
117+
* Formalizes existing widely adopted terminology rather than introducing or prioritizing a different unit
118+
* Focuses on the fundamental base unit that cannot be subdivided further within the Bitcoin protocol
119+
* Maintains the simplicity of a two-tier system (bitcoin and satoshi) rather than adding a third tier
120+
121+
122+
<h4> BIP-177: Redefine Bitcoin's Base Unit </h4>
123+
124+
125+
BIP-177 takes a more radical approach by proposing to redefine the term "bitcoin" to refer to what is currently called a "satoshi" (1/100,000,000 of the current bitcoin). While this proposal aims to eliminate decimal points and simplify mental calculations, our approach differs in that it:
126+
127+
* Preserves the established meaning of "bitcoin" which has global recognition and avoids potentially confusing redefinition
128+
* Maintains compatibility with existing systems, documentation, and user understanding
129+
* Achieves similar clarity benefits through standardization without requiring a fundamental redefinition of terms
130+
131+
132+
<h2> Backwards Compatibility </h2>
133+
134+
135+
This proposal does not affect the technical operation of Bitcoin or its protocol. It is purely a standardization of terminology for human communication and user interfaces.
136+
137+
Existing applications that use other terms or conventions can continue to operate but are encouraged to adopt the standardized terms to improve overall ecosystem clarity.
138+
139+
<h2> Copyright </h2>
140+
141+
142+
This BIP is licensed under the BSD 2-clause license.
143+
144+
<h2> Reference Implementation </h2>
145+
146+
147+
Not applicable as this is an Informational BIP that standardizes terminology rather than implementing technical changes.
148+
149+
<h2> Examples </h2>
150+
151+
152+
Before standardization, various formats might be used:
153+
* 0.00000100 BTC
154+
* 100 satoshi
155+
* 100 satoshis
156+
* 100 sat
157+
* 100 sats
158+
159+
160+
After standardization, the preferred formats would be:
161+
* 100 satoshis (formal)
162+
* 100 sats (abbreviated)
163+
164+
165+
<h2> Acknowledgements </h2>
166+
167+
168+
Thanks to the entire Bitcoin community who has organically adopted the terms "satoshi" and "sats" over the years. If anyone can point to early references of the term being used in this way please leave a comment so we can amend this BIP to acknowledge it.
169+
170+
<h2> References </h2>
171+
172+
173+
1. Satoshi Nakamoto. "Bitcoin: A Peer-to-Peer Electronic Cash System" (2008)
174+
1. BIP-176: Bits Denomination (Jimmy Song)
175+
176+
177+
<h2> Glossary </h2>
178+
179+
180+
* BTC: The current universal ticker symbol for bitcoin, the cryptocurrency.
181+
* Satoshi: The smallest unit of bitcoin, equal to 0.00000001 BTC.
182+
* Sats: Abbreviation for "satoshis".

web/content/177/index.md

Lines changed: 200 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,200 @@
1+
2+
+++
3+
title = "Redefine Bitcoin's Base Unit"
4+
date = 2025-04-23
5+
weight = 177
6+
7+
[taxonomies]
8+
authors = ["John Carvalho"]
9+
status = ["Draft"]
10+
11+
[extra]
12+
bip = 177
13+
status = ["Draft"]
14+
github = "https://github.com/bitcoin/bips/blob/master/bip-0177.mediawiki"
15+
note = "THIS FILE IS AUTOMATICALLY GENERATED - NOT MEANT FOR EDITING"
16+
+++
17+
18+
```
19+
BIP: 177
20+
Title: Redefine Bitcoin's Base Unit
21+
Author: John Carvalho <bitcoinerrorlog@gmail.com>
22+
Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-0177
23+
Status: Draft
24+
Type: Informational
25+
Created: 2025-04-23
26+
License: CC0-1.0
27+
```
28+
29+
30+
<h2>Introduction</h2>
31+
32+
33+
<h3>Abstract</h3>
34+
35+
36+
This BIP proposes redefining the commonly recognized "bitcoin" unit so that the base unit becomes the primary reference unit. Under this proposal, one bitcoin is defined as that indivisible base unit, eliminating the convention of synthetic decimal places. By making the base unit the standard measure, this BIP aims to simplify user comprehension, reduce confusion, and align on-chain values directly with their displayed representation.
37+
38+
<h3>Motivation</h3>
39+
40+
41+
The current convention defines one bitcoin as 100,000,000 base units. This representation requires dealing with eight simulated decimal places, which can be confusing and foster the misconception that bitcoin is inherently decimal-based. In reality, Bitcoin’s ledger represents values as integral base units. The decimal point is merely a human-imposed abstraction.
42+
43+
By redefining the base unit as "one bitcoin," this BIP aligns user perception with the protocol’s true nature. It reduces cognitive overhead, ensures users understand Bitcoin as counting discrete units, and ultimately improves educational clarity and user experience.
44+
45+
<h3>Specification</h3>
46+
47+
48+
**Redefinition of the Unit:**
49+
50+
* Internally, the base units remain unchanged.
51+
* Historically, 1 bitcoin = 100,000,000 base units. Under this proposal, "1 bitcoin" equals one base unit.
52+
* What was previously referred to as "1 bitcoin" now corresponds to 100 million bitcoins under the new definition.
53+
54+
55+
**Terminology:**
56+
57+
* The informal terms "satoshi" or "sat" are deprecated.
58+
* All references, interfaces, and documentation SHOULD refer to the base unit simply as "bitcoin."
59+
* The currency code "BTC" is unaffected by these changes, and continues to mean 100,000,000 base units.
60+
61+
62+
**Display and Formatting:**
63+
64+
* Applications SHOULD allow users to toggle between the legacy BTC format (1 BTC = 100,000,000 base units) and the new integral format (1 bitcoin = 1 base unit).
65+
* Use of the ₿ symbol MAY be used to represent base-unit bitcoins but is OPTIONAL.
66+
67+
68+
Example 1:
69+
70+
* Old display: `0.00010000 bitcoin`
71+
* New display: `₿10,000` or `10,000 bitcoins` or `0.00010000 BTC`
72+
73+
74+
Example 2:
75+
76+
* Old display: `10.23486 bitcoin`
77+
* New display: `₿1,023,486,000` or `1,023,486,000 bitcoins` or `10.23486 BTC`
78+
79+
80+
Example 3:
81+
82+
* Old display: `0.345 BTC`
83+
* New display: No changes required or `₿34,500,000` or `34,500,000 bitcoins`
84+
85+
86+
NOTE: Traditional number display abbreviations, like `2.5M` for millions, are also optional.
87+
88+
**Conversion:**
89+
90+
* Ledger and consensus rules remain unchanged.
91+
* `BTC` as a currency code remains unchanged (1 BTC = 100,000,000 base units)
92+
* Implementations adopting this standard MUST multiply previously displayed bitcoin amounts by 100,000,000 to determine the new integer representation.
93+
94+
95+
<h3>Rationale</h3>
96+
97+
98+
**Usability:**
99+
Integer-only displays simplify mental arithmetic and reduce potential confusion or user error.
100+
101+
**Protocol Alignment:**
102+
The Bitcoin protocol inherently counts discrete units. Removing the artificial decimal format aligns user perception with Bitcoin’s actual integral design.
103+
104+
**Educational Clarity:**
105+
Presenting integers ensures newcomers do not mistakenly assume that Bitcoin’s nature is decimal-based. It conveys Bitcoin’s true design from the start.
106+
107+
**Future-Proofing:**
108+
Adopting the base unit as the primary measure ensures a consistent standard that can scale smoothly as Bitcoin adoption grows.
109+
110+
**Perception of Supply:**
111+
While the total count of base units is roughly 2.1 quadrillion, this proposal does not alter supply in any way. The change is purely representational. Comparisons can be drawn to other currencies like the Japanese yen or Indonesian rupiah, where high unit counts are standard and not perceived as inflationary.
112+
113+
<h3>Addressing Alternative Approaches</h3>
114+
115+
116+
**Refuting the "Bits" Proposal**
117+
(<a href="/176" target="_blank">BIP 176</a>)
118+
119+
An alternative suggestion (BIP 176) proposes using "bits" to represent one-millionth of a bitcoin (100 satoshis). While this reduces the number of decimal places in certain contexts, it fails to fully address the core issues our BIP aims to solve:
120+
121+
1. **Persistent Decimal Mindset:**
122+
Using "bits" still retains a layered decimal approach, requiring users to think in terms of multiple denominations (BTC and bits). This shifts complexity rather than eliminating it.
123+
124+
2. **Inconsistent User Experience:**
125+
Users must learn to toggle between BTC for large amounts and bits for small amounts. Instead of providing a unified view of value, it fragments the user experience.
126+
127+
3. **Incomplete Alignment with the Protocol’s Nature:**
128+
The "bits" proposal does not realign the displayed value with the integral nature of Bitcoin’s ledger. It continues to rely on fractional units, masking the fundamental integer-based accounting that Bitcoin employs.
129+
130+
4. **Not Permanently Future-Proof:**
131+
Though "bits" may simplify certain price ranges, future circumstances could demand additional denominations or scaling adjustments. Our integral approach resolves this problem entirely by making the base unit the standard measure, avoiding future fragmentation.
132+
133+
In essence, while BIP 176 attempts to simplify small amount representations, it only replaces one decimal representation with another. By redefining "bitcoin" as the base unit, this BIP eliminates reliance on decimal fractions and separate denominations entirely, offering a clearer, more intuitive, and ultimately more durable solution.
134+
135+
<h3>Handling the Terms “satoshi” and “sat”</h3>
136+
137+
138+
**Background**
139+
140+
“Satoshi” (or its shorthand “sat”) emerged organically some years ago, to honour Bitcoin’s creator and to give a friendly name to the 100-millionth "fraction" of a bitcoin.
141+
Over time “stacking sats” became a meme, and the term now appears in podcasts, apparel, and some wallet UIs.
142+
143+
While culturally valuable, the term introduces an implicit second denomination layer that contradicts the goal of this BIP: a single base unit, called simply "bitcoin". Of course this BIP cannot stop anyone from using any colloquial term they prefer, but this document exists to specify how to display Bitcoin's only units as "bitcoin" correctly.
144+
145+
<h3>Backward Compatibility</h3>
146+
147+
148+
No consensus rules are altered, and on-chain data remains unchanged. Differences arise solely in display formats:
149+
150+
* **For Developers:** Update GUIs, APIs, and documentation to present values as integers. Remove references to fractional Bitcoin. `BTC` units remain unchanged.
151+
152+
153+
* **For Users:** The actual value of holdings does not change. Transitional measures, such as dual displays or explanatory tooltips, can ease the adjustment period.
154+
155+
156+
<h3>Security Considerations</h3>
157+
158+
159+
A short-term risk of confusion exists as users adapt to the new representation. Users accustomed to decimals may misinterpret initial displays. To mitigate this:
160+
161+
* Offer dual displays and tooltips during the transition.
162+
* Provide clear educational materials and coordinated messaging.
163+
* Use alerts or confirmations in applications if input values appear unexpectedly large or small.
164+
* Highlight the unchanging 21M BTC supply cap and equivalence to avoid misinterpretation as inflationary.
165+
166+
167+
<h3>Reference Implementation</h3>
168+
169+
170+
Some wallets, such as Bitkit, have successfully adopted integer-only displays, demonstrating the feasibility of this approach, without incident. Transitional features — like showing both old and new formats side-by-side — can help smooth the transition.
171+
172+
<h3>Test Vectors</h3>
173+
174+
175+
* Old: `1.00000000 Bitcoin` → New: `₿100,000,000` (or `100,000,000 bitcoins`)
176+
* Old: `0.00010000 Bitcoin` → New: `₿10,000` (or `10,000 bitcoins`)
177+
* Old: `0.00500000 Bitcoin` → New: `₿500,000` (or `500,000 bitcoins`)
178+
* Old: `0.005 BTC` → New: `0.005 BTC` (or `₿500,000` or `500,000 bitcoins`)
179+
180+
181+
All formerly fractional representations now directly correspond to whole-number multiples of the base unit.
182+
183+
<h3>Implementation Timeline</h3>
184+
185+
186+
**Phase 1 (3-6 months):** Introduce the concept, provide dual displays and educational materials. Begin pilot testing in willing wallet apps.
187+
188+
**Phase 2 (6-12 months):** Prominent services adopt integer-only displays by default. Community coordination and media campaigns ensure consistency.
189+
190+
**Phase 3 (12+ months):** Integer representation becomes standard. Documentation and user guides no longer reference decimal-based formats.
191+
192+
<h3>Conclusion</h3>
193+
194+
195+
Redefining "bitcoin" as the smallest indivisible unit, and removing decimal-based representations, simplifies comprehension and aligns displayed values with the protocol’s integral accounting. While a transition period may be necessary, the long-term benefits include clearer communication, reduced confusion, and a more accurate understanding of Bitcoin’s fundamental design.
196+
197+
<h3>Copyright</h3>
198+
199+
200+
This BIP is licensed under CC0-1.0.

0 commit comments

Comments
 (0)