-
Notifications
You must be signed in to change notification settings - Fork 5.8k
BIP-XYZ: Standardized emoji based wordlist for future apps #1999
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
ovrdos
wants to merge
19
commits into
bitcoin:master
Choose a base branch
from
emojiseed:feature/bip-xyx-proposal
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+2,157
−0
Open
Changes from 18 commits
Commits
Show all changes
19 commits
Select commit
Hold shift + click to select a range
3c66017
Adding bip files to bitcoin/bip 🙏🏾
c3c837a
Adding bip files to bitcoin/bip 🙏🏾
e238bcc
Adding bip files to bitcoin/bip 🙏🏾
3dc3a33
refreshing emoji.txt
c553dd2
Fixing copyright typo
16a9282
adding updated emoji definitions
116d357
adding update emojis
68bd369
adding documentation update
6c28e27
adding emoji file
4f1b3ca
Typos cicd is not finding typos
e622be0
clearing typos
8d2ed8e
clearing typos
1f743b9
Correcting typos
e55e92b
adding updated emaoji
6df875e
updating emoji list
999fc6d
updating emoji list
b7ebcda
updating emoji list
b206e08
adding udated emoji.txt
e4fbae9
Fix formatting in bip-XYZ-wordlists.md
ovrdos File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,40 @@ | ||
<pre> | ||
BIP: ? | ||
Layer: Applications | ||
Title: Standardized emoji based wordlist for future apps | ||
Author: Emoji Seed Dev Team <[email protected]> | ||
Comments-Summary: https://emojiseed.com/#readme | ||
Comments-URI: https://emojiseed.com/discussions | ||
Status: Draft | ||
Type: Standards Track | ||
Created: 2025-10-03 | ||
License: MIT | ||
</pre> | ||
|
||
==Abstract== | ||
|
||
This BIP describes a standardized mapping between a special wordlist | ||
and unique pairs of emoji characters to enable mnemonic phrases to be represented | ||
in a universally recognizable, language agnostic form, while remaining compatible | ||
with existing deterministic wallet standards. | ||
|
||
This BIP describes the implementation of a mnemonic code or mnemonic sentence | ||
a group of easy to remember emojisets for the generation of deterministic wallets. | ||
|
||
==License== | ||
|
||
This BIP inherits the MIT License. | ||
|
||
==Motivation== | ||
|
||
1. Preparing a data library for application teams. | ||
2. Helping users who may struggle with word based language types. | ||
3. Setting an industry respected standard for Emoji language mnemonics. | ||
4. Starting a community around Emoji masking devices for seed phrases. | ||
5. Imprinting a unique, everlasting, dataset into the universal lexicon. | ||
|
||
==Reference Implementation== | ||
|
||
Reference implementation including wordlists is available from | ||
- https://emojiseed.com/#readme | ||
- https://github.com/emojiseed/emoji-mnemonic |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,70 @@ | ||
# Wordlists | ||
|
||
* [Emoji](emoji.txt) | ||
|
||
## Wordlists (Special Considerations) | ||
|
||
### Emoji | ||
|
||
Credits: @EmojiSeedDevTeam | ||
|
||
The Emoji wordlist is a deterministic mapping of the 2048 special words into | ||
2048 unique pairs of emoji. It enables mnemonic phrases to be displayed visually | ||
while remaining fully compatible with existing semantic seeds. | ||
|
||
Emojis are chosen using the following rules: | ||
|
||
1. Direct Match: if a word has a clear, universal emoji, duplicate it. | ||
2. Months and holidays use seasonal/holiday symbols. | ||
3. Numeric words map to keycap digits. | ||
4. Abstract and Action Words use a primary metaphor plus a clarifier emoji. | ||
5. Nouns: object clarifier. Verbs/participles: action clarifier. | ||
6. Duplicate only for strong iconic matches; add clarifiers for ambiguity; if unresolved, fall back deterministically. | ||
7. All 2048 pairs MUST be unique. If a collision occurs, rotate clarifier, then primary, and finally apply the fallback. | ||
8. Use only fully-qualified Unicode emoji graphemes (per Unicode TR51). Avoid variation selectors and platform-specific implementations. | ||
9. All curation rules are available here: https://emojiseed.com#readme | ||
|
||
==== Security Notes ==== | ||
|
||
* No protocol changes: entropy, checksum, and wordlists are unchanged. | ||
* Rendering differences across platforms exist; compare by code points (not rasterized glyphs). | ||
* Wallets that do not support Emoji can ignore this wordlist without impact. | ||
|
||
==== License ==== | ||
|
||
This addition inherits the MIT license.# Wordlists | ||
|
||
* [Emoji](emoji.txt) | ||
|
||
## Wordlists (Special Considerations) | ||
|
||
### Emoji | ||
|
||
Credits: @EmojiSeedDevTeam | ||
|
||
The Emoji wordlist is a deterministic mapping of the 2048 special words into | ||
2048 unique pairs of emoji. It enables mnemonic phrases to be displayed visually | ||
while remaining fully compatible with existing semantic seeds. | ||
|
||
Emojis are chosen using the following rules: | ||
|
||
1. Direct Match: if a word has a clear, universal emoji, duplicate it. | ||
2. Months and holidays use seasonal/holiday symbols. | ||
3. Numeric words map to keycap digits. | ||
4. Abstract and Action Words use a primary metaphor plus a clarifier emoji. | ||
5. Nouns: object clarifier. Verbs/participles: action clarifier. | ||
6. Duplicate only for strong iconic matches; add clarifiers for ambiguity; if unresolved, fall back deterministically. | ||
7. All 2048 pairs MUST be unique. If a collision occurs, rotate clarifier, then primary, and finally apply the fallback. | ||
8. Use only fully-qualified Unicode emoji graphemes (per Unicode TR51). Avoid variation selectors and platform-specific implementations. | ||
9. All curation rules are available here: https://emojiseed.com#readme | ||
|
||
==== Security & Interop Notes ==== | ||
|
||
* No protocol changes: entropy, checksum, and wordlists are unchanged. | ||
* Rendering differences across platforms exist; compare by code points (not rasterized glyphs). | ||
* Wallets that do not support Emoji can ignore this wordlist without impact. | ||
|
||
==== License ==== | ||
|
||
This addition inherits the MIT license. | ||
|
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.