Bytewords

Overview

Bytewords is a method for encoding binary objects as a sequence of four-letter English words.

Why is Bytewords Important?

Encoding binary strings as human-readable words allows for better human interaction. Blockchain Commons adopted this approach not only for improved human interactivity, but also so that CBOR data structures could be encoded in a self-describing way, increasing their resilience.

BIP39 and SLIP39 offered two existing methods for textual encoding of binary data, but were ultimately found insufficient. Bytewords offers advantages over existing schemes, including: use of words with a uniform length of four letters; ability to minimally encode words with two letters; addition of a checksum;and specific selection of “interesting” words for improved memory.

Bytewords is used by the Uniform Resources specification.

How Does Bytewords Work?

CBOR data is converted to a hex string and a CRC32 checksum is appended to it. Each byte of the hex string is then converted to one of the 256 words on Bytewords word list. For “minimal” encoding, each byte is instead encoded as the first and last character of the appropriate entry on the Bytewords list, which have been designed to be unique.

“BCR-2020-012: Bytewords” lists the complete set of words and provides examples.

How Does Bytemoji Work?

Words aren’t the only ways to identify things! Blockchain Commons has also released “Bytemoji”, a set of 256 emojis that can be used to generate visual strings. As with Bytewords, the Bytemojis were carefully curated to focus on emojis that are distinct, don’t rely on color differences, read well at small sizes, and otherwise are easy to distinguish and remember. They were also selected to serialize as 3 or 4 UTF-8 bytes and to render as a single glyph

Bytemojis are intended to be released as “clusters” of four or more bytemojis, which together can produce a strong recognition of a digital object:

🌊 😹 🌽 🐞
JUGS DELI GIFT WHEN
71 27 4d f1

“BCR-2024-008: Bytemoji” lists the complete set of emojis and provides examples.

Bytewords Videos

Bytewords in Technical Overview

Libraries

Bytewords Libraries

Language	Repo	Contributor	Status
C	bc-bytewords	Blockchain Commons
Java	bc-libs-java	Bitmark