SynthOS logoSynthOS

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

Wallet Architecture

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:

  1. Embedded Wallet (Privy) → Your signer for app interactions
  2. Smart Wallet → Executes your investments (gasless + cross-chain)
  3. 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.