> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ekiden.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# User Flows

> Learn how to create, import, unlock, and use Ekiden Wallet.

This guide covers the main actions available in the Ekiden Wallet browser extension, from creating a wallet to approving transactions and managing networks.

## First open

No vault yet. The splash offers **Create wallet** and **Import seed**.

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/splash.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=96ad21b685e859ea53e48adc78eb6e54" alt="Ekiden Wallet welcome screen with Create wallet and Import seed options" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="712" height="1184" data-path="images/splash.png" />

Create asks them to write down the 12 words, confirm, choose a party name (`ekiden-<name>`), and set a password.

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/seed-1.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=a45070d7c1873173cc02f8b3dd90a375" alt="Wallet recovery phrase setup" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="706" height="1188" data-path="images/seed-1.png" />

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/password-1.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=cfff704a7cc6b4fcaa14694b7b5f472f" alt="Party name and password setup" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="712" height="1188" data-path="images/password-1.png" />

Import asks for the same phrase, then the same party name. The name has to match the party that was allocated with that seed. Fingerprint-only restore does not find the party on this ledger.

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/import-1.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=f6179a836efd5c4bf0aea28c52801f55" alt="Import an existing wallet using a recovery phrase" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="724" height="1202" data-path="images/import-1.png" />

## Unlock

The vault exists and the session is locked. Password, then **Unlock**. **Sign out / remove wallet** deletes the local vault. The seed still restores it.

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/unlock.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=2bab9a705cb59b936b90966975c4b42f" alt="Ekiden Wallet unlock screen" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="716" height="1196" data-path="images/unlock.png" />

## Home

After unlock: party, network, balances. Send, receive, and settings hang off this screen.

<img src="https://mintcdn.com/ekiden/ldVqp95q9gqiW1uu/images/home.png?fit=max&auto=format&n=ldVqp95q9gqiW1uu&q=85&s=955730e49f9e7e67b9d407ac35e77ab3" alt="Ekiden Wallet home screen showing party, network, and balances" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="710" height="1204" data-path="images/home.png" />

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/recieve.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=f6a5077a1e8b9688ba70363b02fd1872" alt="Receive screen displaying the full Canton party ID" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="712" height="1210" data-path="images/recieve.png" />

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/send.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=392fe11b45c1bfbfbcb8cb7e9029bc7f" alt="Send assets screen with instrument, amount, and recipient" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="714" height="1192" data-path="images/send.png" />

Incoming transfer instructions show as offers the user can accept or reject.

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/offer-1.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=29c91612940c3111b96e272ce24c12d1" alt="Incoming transfer offer with Accept and Reject actions" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="698" height="1192" data-path="images/offer-1.png" />

## A website connects

The site calls `connect`. The extension opens an approval with the origin and the dApp name.

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/approve-connect.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=2fbb54aad20cf22fcebba3ba3349df51" alt="dApp connection approval popup" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="752" height="1276" data-path="images/approve-connect.png" />

Signing a message and submitting a transaction are the same popup family, with the payload summarized.

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/approve-sign-1.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=fb61e6e40ce6c53171b165edbfad156c" alt="Message signing approval popup" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="758" height="1280" data-path="images/approve-sign-1.png" />

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/approve-tx-1.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=7f6b7b9f12ae0b99df6c88e9072c1c13" alt="Transaction approval popup showing command summary" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="762" height="1278" data-path="images/approve-tx-1.png" />

If the user rejects, the site receives “User rejected request” (`4001` on the CIP-0103 path). If they accept a transaction, the wallet signs and submits, then the site sees `executed` and an `updateId`.

## Network

The user picks the network in the wallet. A dApp cannot switch it. A network marked coming soon cannot create or use an account.

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/network.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=9f87656082a9007df6240ab767cdb9f6" alt="Wallet network selection screen" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="714" height="1188" data-path="images/network.png" />

## Lock and remove

Lock ends the session and returns to Unlock. Sign out removes the vault from this browser profile.

<img src="https://mintcdn.com/ekiden/coIbOVnLWg3ojKNF/images/settings.png?fit=max&auto=format&n=coIbOVnLWg3ojKNF&q=85&s=30a8c7a0c008a461ac44b85777b1943a" alt="Wallet settings with lock and remove wallet options" className="!w-[320px] !max-w-[320px] h-auto block mx-auto" width="718" height="1190" data-path="images/settings.png" />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.