> For the complete documentation index, see [llms.txt](https://docs.fluvion.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fluvion.io/getting-started/account-and-wallet.md). # Wallet & Account Setup This guide explains how your trading account works on Fluvion, including multi-chain wallet connections, email social logins, cryptographic session keys, and portfolio balance metrics. *** ## Supported Login & Wallet Methods Fluvion offers a flexible, multi-chain onboarding experience. You can access the DEX using your preferred Web3 wallet or simply sign in with your email: ``` +-------------------------------------------------------------------------------+ | CONNECT TO FLUVION DEX | +-------------------------------------------------------------------------------+ | [📧 Continue with Email] | | (Instant embedded wallet, zero seed-phrase setup) | |-------------------------------------------------------------------------------| | SOLANA WALLETS | EVM & MULTI-CHAIN WALLETS | | - Phantom | - MetaMask | | - Solflare | - Rabby Wallet | | - Backpack | - Coinbase Wallet | | - WalletConnect (Mobile) | - Rainbow / WalletConnect | +-------------------------------------------------------------------------------+ ``` ### 1. 📧 Email / Social Login (Embedded Wallet) * **Instant Onboarding**: Sign in with your email address via a one-time passcode (OTP). * **Self-Custodial & Secure**: An embedded non-custodial wallet is automatically provisioned for you. No browser extension installation or seed-phrase management required. * **Ideal For**: New Web3 traders seeking the frictionless UX of a centralized exchange with the non-custodial guarantees of DeFi. ### 2. 🟣 Solana Wallets * Natively supported via the Solana Wallet Adapter: * **Phantom** (Extension & Mobile) * **Solflare** (Extension & Mobile) * **Backpack** (Extension & Mobile) * **WalletConnect** for mobile QR linking. * Used for direct Solana-native USDC deposits and withdrawals. ### 3. 🔷 EVM & Multi-Chain Wallets * Connect using your existing Ethereum/EVM wallet across supported networks: * **Supported Networks**: **Ethereum**, **Robinhood Chain**. * **Supported Wallets**: **MetaMask**, **Rabby**, **Coinbase Wallet**, **Rainbow**, **OKX Wallet**, and any **WalletConnect** compatible provider. * Deposit USDC directly from Ethereum or Robinhood Chain into your Fluvion unified trading account without manually bridging to Solana first! *** ## The Session Key Architecture Traditional decentralized exchanges force users to approve and sign a separate blockchain transaction for every single order submission, cancellation, or TP/SL update. This introduces latency, gas costs, and severe friction during volatile market conditions. Fluvion solves this through **Cryptographic Session Keys** across all wallet types: ```mermaid sequenceDiagram autonumber actor Trader as Trader (Email / Solana / EVM) participant Client as Fluvion Web App participant Engine as High-Performance CLOB participant Vault as Multi-Chain Smart Contract Vault Trader->>Client: Connect via Email, Phantom, or MetaMask Client->>Trader: Request Session Key Signature (1-day to 30-day validity) Trader->>Client: Signs message (EIP-712 for EVM / Off-chain for Solana / Embedded for Email) Note over Client,Engine: Gasless, sub-second trading enabled! Trader->>Client: Place Limit / Market Order Client->>Engine: Order signed via Session Key (0 gas, <20ms) Engine->>Client: Order Accepted / Filled Note over Trader,Vault: Fund Movements Require Primary Wallet Signature Trader->>Vault: Withdraw USDC Collateral (Signed by Primary Key) Vault->>Trader: USDC Transferred to User Wallet ``` ### Key Security Properties of Session Keys: 1. **Zero Fund Access**: A session key can only sign trade actions (order placement, cancellation, and position modifications). It **cannot** withdraw, transfer, or redirect your collateral. 2. **Standardized Across Chains**: * **Solana**: Signs a standard Solana off-chain message. * **EVM (Ethereum / Robinhood)**: Signs an **EIP-712** typed structured data message. * **Email Login**: Managed securely via encrypted MPC key-shares. 3. **Time-Bound**: Session keys are valid for a configurable window (e.g., 24 hours or up to 30 days) and expire automatically. 4. **Revocable Anytime**: You can revoke the active session key instantly through the UI settings or by disconnecting your wallet. *** ## Account Structure & Balances Regardless of whether you connect via Solana, Ethereum, Robinhood, or Email, your account dashboard displays a unified balance view: ### 1. Total Account Value (Equity) The total net worth of your account, combining deposited USDC and open position performance: ``` Total Equity = USDC Balance + Unrealized PnL (uPnL) ``` ### 2. Free Collateral (Available to Trade) The margin currently free to open new positions or place resting limit orders: ``` Free Collateral = Total Collateral + uPnL - Total Initial Margin with Orders ``` ### 3. Margin Usage The percentage of your collateral currently tied up as Initial Margin for open positions and active orders: ``` Margin Usage % = (Total Initial Margin / Total Collateral Value) × 100 ``` ### 4. Account Margin Ratio (AMR) The single most critical health indicator of your account: ``` Account Margin Ratio = Total Collateral Value / Total Notional Position Value ``` * When you have no open positions, the margin ratio defaults to **1000%**. * As your positions grow or incur unrealized losses, AMR decreases. * If AMR falls below the **Maintenance Margin Ratio (MMR)**, liquidation is triggered. *** ## Multi-Account Management & Switching If you run multiple distinct strategies (e.g., high-leverage scalping vs. swing holding), you can: * **Switch Wallets or Chains**: Seamlessly switch between different Solana addresses, EVM accounts, or Email logins. Fluvion will immediately reload the account state for the active account. * **Use Isolated Margin**: Keep different strategies within the same account without risk contagion by using **Isolated Margin** mode for specific trades. *** ## Security Best Practices * **Never share your wallet seed phrase or private keys** with anyone. Fluvion admins and support staff will never ask for your private key. * **Always verify the URL** (`https://fluvion.io`) to prevent phishing attempts. * **Disconnect sessions on public computers**: After completing your trading session on a shared computer, click your account address in the header and select **Disconnect & Clear Session**. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.fluvion.io/getting-started/account-and-wallet.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.