Skip to main content
Your recovery phrase is a sequence of 24 English words that encodes the master secret for your Walley wallet. It is the only way to restore access to your funds if your passkey is unavailable. Treat it as the most sensitive piece of information associated with your wallet — anyone who has it can access your assets.

​
How Your Recovery Phrase Is Generated

Walley generates your recovery phrase entirely within your browser at the moment you create your wallet. It follows the BIP-39 standard and uses an Ed25519 key derivation scheme.
Your recovery phrase is generated client-side and is never transmitted to Walley’s servers or stored anywhere outside your browser session. Once you close the generation screen, Walley cannot show it to you again.
Because the phrase is never sent to any server, there is no server-side backup to fall back on. The responsibility for preserving it rests entirely with you.

​
How Recovery Works

If your passkey is unavailable — for example, after losing your device or clearing your browser storage — you can use your recovery phrase alongside your Party Hint to start a recovery session. Your Party Hint is the human-readable label you chose when you created your wallet (prefixed walley-). Walley uses it together with your 24 words to locate and unlock your on-ledger identity. See Canton Network for more on Party Hints.
  1. Open Walley and select Recover Wallet on the sign-in screen.
  2. Enter your 24-word recovery phrase in the correct order.
  3. Enter your Party Hint (for example, walley-yourname).
  4. Walley validates the phrase and establishes a temporary session.
  5. Your wallet is accessible for the duration of that session.

​
Recovery Creates a Temporary Session

A recovery session gives you access to your wallet, but it does not permanently link your recovery phrase to a new passkey. When the session ends, you will need your recovery phrase again to authenticate without a passkey.
Recovery does not replace your passkey. Each time you recover, you must enter all 24 words again. There is currently no flow to bind the recovery phrase to a new passkey — keep this in mind when planning how you access your wallet long-term.

​
How to Store Your Recovery Phrase Safely

Because your recovery phrase is generated only once and never stored by Walley, you must record and protect it yourself. Follow these practices:

Write It on Paper

Write all 24 words in order on paper immediately after your wallet is created. Confirm each word carefully before closing the setup screen.

Store It Offline

Keep the written phrase in a secure physical location — a safe, a safety deposit box, or another place protected from theft and environmental damage.

Never Share It

No legitimate support agent, dApp, or service will ever ask for your recovery phrase. Anyone who asks for it is attempting to steal your funds.

Avoid Digital Storage

Do not save your phrase in a notes app, email, screenshot, cloud storage, or password manager. Digital storage is vulnerable to breaches and sync leaks.
Consider making two physical copies stored in separate locations. This protects against a single point of failure such as a house fire or flood.

​
What Happens If You Lose Your Recovery Phrase

If you lose your passkey and your recovery phrase, access to your wallet is permanently lost. Walley cannot recover your wallet, reset your credentials, or restore your funds under any circumstances. There is no exception to this rule.
This is the fundamental nature of self-custody. Secure your recovery phrase before you ever receive or transact any assets.