BIP-Yi: A Physical Engineering Standard for Mnemonic Representation

简体中文 | English

Representing BIP-39 mnemonics with I Ching hexagrams and trigrams. A bit-perfect conversion protocol optimized for handwriting and metal engraving.

---

Overview

BIP-Yi is a tool that transforms 132-bit mnemonic entropy into I Ching symbols. It provides two backup modes optimized for different physical media:

1. Hexagram Mode (Default): 22 hexagrams (6 bits each) for high-density handwriting.
2. Trigram Mode (Planned): 44 trigrams (3 bits each) optimized for metal engraving using only 8 unique templates.

---

Core Logic

The transformation is a direct, lossless resampling of the 132-bit entropy stream:

Standard	Unit	Length	Total Entropy
BIP-39	11-bit Word	12	132 bits
BIP-Yi (Hexa)	6-bit Hexagram	22	132 bits
BIP-Yi (Bagua)	3-bit Trigram	44	132 bits

Equivalence: $12 \times 11 = 22 \times 6 = 44 \times 3 = 132$

---

Visual Output

The tool renders a vertical "Bamboo Slip" layout using Unicode box-drawing characters:

---

Roadmap

• v0.1.0 (Current): Core engine & Hexagram mode.

• v0.2.0 (Planned): Trigram mode for 8-template engraving.

• v0.3.0 (Planned): Bidirectional decoding (Symbols to Words).

---

Security Considerations

• Entropy Conservation: This protocol is a deterministic mapping. The security of the resulting sequence is identical to the source mnemonic.

• Air-Gapped Execution: Users are advised to run BIP-Yi in a non-networked environment to mitigate side-channel risks.

---

Usage

# Clone and Install
git clone git@github.com:letsEstel/bip-yi.git
cd bip-yi && bundle install

# Execute Default Hexagram Mode
./bin/bip_yi "your twelve secret words..."

---

License

Licensed under the MIT License.