Wallet Architecture
Explains embedded wallet, EOA login, smart wallet, how each is used.
Before you start, here is a quick overview of how wallets and deposits work in SynthOS:
Wallet Model in SynthOS

When you sign in to SynthOS either with social login (e.g. Google, Apple, email) or an EOA wallet (e.g. MetaMask, Phantom), the app sets up two wallets for you:
1. Embedded Wallet (Privy)
This is a non-custodial wallet created for every user by default. It acts as your primary signer inside SynthOS.
You control it fully:
- It lives inside your login session
- It does not require browser extensions
- It is not your EOA address
2. SynthOS Smart Wallet
This is a smart contract wallet that is also created automatically and is used to:
- Execute gasless transactions
- Perform cross-chain vault deposits
- Handle bridging and swapping
- Interact with strategies and vaults safely
All actual deposits into vaults happen from this Smart Wallet, not from your embedded wallet or your EOA.
Why Deposits Use the Smart Wallet
SynthOS relies on the Smart Wallet to provide a smooth, cross-chain investing experience:
Gasless Transactions
The Smart Wallet allows SynthOS to pay gas fees on your behalf.
You can deposit, allocate, and rebalance without holding gas tokens.
Cross-Chain Deposits
You can invest into vaults on other chains even if your assets are on a different chain.
SynthOS handles:
- Bridging
- Swapping
- Routing
- Gas coverage
All executed through the Smart Wallet.
Non-Custodial Control
The Smart Wallet is still owned by you.
SynthOS cannot move your funds — it only sponsors gas.
In summary:
- Embedded Wallet (Privy) → Your signer for app interactions
- Smart Wallet → Executes your investments (gasless + cross-chain)
- EOA (optional) → Additional login method only
To deposit into vaults, you will first move assets into the Smart Wallet, and the Smart Wallet will perform all transactions needed for your deposit.