recode

recode

Package recode provides functionality to encode and decode any byte data into a mnemonic and back, using a custom word list.

The word list must have a length that is a power of two (e.g., 2, 4, 8, 16, ...).

Example

package main

import (
    "log"
    "github.com/fullpipe/recode"
)

func main() {
    rec, err := recode.NewDictionary(
        []string{"my", "own", "random", "words", "to", "have", "more", "fun"},
    )
    if err != nil {
        log.Fatal(err)
    }

    // Encode the byte data
    mnemonic, err := rec.Encode([]byte("nice!"))
    if err != nil {
        log.Fatal(err)
    }

    log.Println(mnemonic) // have words words to more to have ...

    // Decode the mnemonic back to byte data
    decoded, err := rec.Decode(mnemonic)
    if err != nil {
        log.Fatal(err)
        return
    }
    log.Println(string(decoded)) // nice!
}

You can use more familiar dictionaries like bip39 or slip39:

recBip, _ := recode.NewDictionary(recode.Bip39Dictionary)
recSlip, _ := recode.NewDictionary(recode.Slip39Dictionary)

Beware: The resulting mnemonic will differ from the original bip39 and slip39!

But who needs bip39 if you can use fruits & vegetables?

...
entropy, _ := bip39.NewEntropy(256)

fruits, _ := recode.NewDictionary([]string{"🍇", "🍈", "🍉", "🍊", "🍋", "🍌", "🍍", "🥭", "🍎", "🍐", "🍑", "🍒", "🍓", "🫐", "🥝", "🍅", "🫒", "🥥", "🥑", "🍆", "🥔", "🥕", "🌽", "🌶️", "🫑", "🥒", "🥬", "🥦", "🧄", "🧅", "🥜", "🫘"})

salat, _ := fruits.Encode(entropy)

log.Println(string(salat)) // 🍒 🧄 🍆 🥕 🥑 🫑 🍉 🍇 🥔 🫚 🥥 🍍 🍎 🌽 🍑 ...

Features and restrictions

• Custom Word List: Use your own set of words for encoding and decoding.
• Flexible: Works with any byte data, of any length.
• Power of Two: The word list must have a length that is a power of two.
• Checksum: The checksum is included in the mnemonic, ensuring data integrity.

Contributing

Contributions are welcome! Please submit a pull request or open an issue for any bugs or feature requests.