- 
                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 all 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 <bip-devs@emojiseed.com> | ||
| 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. | ||
|  | ||
| * [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.