Wallet Structures

When integrating Morpho Earn, the wallet architecture you choose determines how user funds flow onchain, who holds custody of assets, and how accounting is handled. This page presents the five main wallet structures available to integrators.

Overview

1. Omnibus Only

All user funds are pooled in one omnibus account, with virtual accounting handled off-chain.

• Typical Actors: CEXs & CeFi
• Tech Providers: Bridge, Fireblocks, Taurus or custom KMS
• Earn integration key points:
  • Offchain accounting needed (already standard for CeFi)
  • Integrator must handle reward distribution to user balances

2. Omnibus + Custodial Wallets

Default omnibus entry point, but with per-user onchain wallets (custodial: the user does not hold the private keys).

• Typical Actors: CEX, CeFi, neo-banks
• Tech Providers: Bridge, Fireblocks, Taurus
• Earn integration key points:
  • Individualized positions onchain
  • Integrator side must manage reward allocation & gas efficiency

3. Custodial Wallets Only

Only per-user wallets, fully managed by the integrator (no omnibus).

• Typical Actors: Stripe-like models, custodial fintechs
• Tech Providers: Bridge, Fireblocks, Taurus
• Earn integration key points: Straightforward Earn setup, no omnibus complexity

4. Omnibus + Non-Custodial Wallets

Omnibus for entry, but users have non-custodial wallets with some integrator-controlled features.

• Typical Actors: CEXs onchain oriented
• Tech Providers: Smart contract wallets (Alchemy, Gelato), SDKs & AA tooling (Privy, Turnkey)
• Earn integration key points:
  • Earn flows are user-controlled onchain or in the app
  • Integrator can retain some control logic

5. Non-Custodial Wallets Only

Pure onchain setup. No omnibus, users fully manage their own wallets.

• Typical Actors: Onchain protocols
• Tech Providers: Non-custodial wallets (Metamask, Rabby, Safe, Ledger, ...)
• Earn integration key points: n/a (fully decentralized)