xolosArmy Network — Dev Column

Animated mini-tutorial: what a seed is, what a derivation path is, and why it matters.

Topic: Wallet Basics
Style: Didactic + Fun
Audience: Builders + Newcomers

Seed vs Derivation Path: “Same words, different wallet?!” 🧠🐕

Imagine your wallet is a sacred temple. The seed phrase is the master key… but the derivation path is the corridor map inside the temple. Same key + different corridor = you open a different door.

🎬 Scene 1 — “What is a seed?”

A seed phrase (12/24 words) is the master secret that can generate your keys. It’s not your coins — it’s the origin of your keys. Treat it like your “do-not-leak” ancient spell.

Seed = the source that can generate countless addresses. NEVER share it

🎬 Scene 2 — “What is a derivation path?”

A derivation path is the recipe that tells the wallet which branch of keys to generate from the seed. Change the path, and the wallet walks a different branch — producing different addresses.

Derivation Path = the route inside the “key tree” A.K.A. HD path
wallet.keys(seed, path)
// Same seed + different path = different addresses

seed = "twelve words ... twenty-four words"

path A = m/44'/899'/0'/0/0   // eCash-style branch
path B = m/44'/1899'/0'/0/0  // CashTab-style branch

address(seed, path A) != address(seed, path B)

🎬 Scene 3 — Tonalli Wallet’s official derivation path (English)

Tonalli Wallet uses this derivation path: m/44'/899'/0'/0/0
That means Tonalli derives addresses from the eCash-style branch.

Tonalli Path: m/44'/899'/0'/0/0 stable
Friendly warning: If you import a seed from another wallet that uses a different path (example: CashTab path m/44'/1899'/0'/0/0), you may see a different address. That doesn’t mean funds were stolen — it usually means you’re looking at a different branch of the same seed.